# generaltranslation: General Translation Core SDK: formatRelativeTime
URL: https://generaltranslation.com/it/docs/core/class/methods/formatting/format-relative-time.mdx
---
title: formatRelativeTime
description: Riferimento API del metodo formatRelativeTime per formattare valori temporali relativi
---

## Panoramica

Il metodo `formatRelativeTime` formatta un valore temporale relativo con un'unità esplicita, in base alle convenzioni specifiche dell'impostazione regionale.

```typescript
const gt = new GT();
const formatted = gt.formatRelativeTime(-1, 'day', {
  locales: 'en-US',
  numeric: 'auto'
});
// Restituisce: "yesterday"
```


## Riferimento

### Parametri

| Nome       | Tipo                          | Descrizione                                                                                     |
| ---------- | ----------------------------- | ----------------------------------------------------------------------------------------------- |
| `value`    | `number`                      | Il valore temporale relativo (negativo per il passato, positivo per il futuro)                 |
| `unit`     | `Intl.RelativeTimeFormatUnit` | L'unità di tempo (`'second'`, `'minute'`, `'hour'`, `'day'`, `'week'`, `'month'`, `'year'`) |
| `options?` | `object`                      | Configurazione del formato                                                                      |

### Opzioni

| Nome             | Tipo                            | Descrizione                                                                                                                    |
| ---------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `locales?`       | `string \| string[]`            | Impostazioni locali per il formataggio. Per impostazione predefinita, usa le impostazioni locali di rendering dell'istanza |
| `numeric?`       | `'always' \| 'auto'`            | Indica se usare sempre un output numerico. Il valore predefinito è `'auto'`                                                    |
| `style?`         | `'long' \| 'short' \| 'narrow'` | La lunghezza dell'output. Il valore predefinito è `'long'`                                                                 |
| `localeMatcher?` | `'best fit' \| 'lookup'`        | L'algoritmo di corrispondenza delle impostazioni locali da usare                                                           |

### Restituisce

`string` - La stringa con il tempo relativo formattato.

***

## Esempio

```typescript copy
import { GT } from 'generaltranslation';
const gt = new GT();

// Tempo passato
gt.formatRelativeTime(-2, 'hour', { locales: 'en-US' });
// Restituisce: "2 hours ago"

// Tempo futuro
gt.formatRelativeTime(3, 'day', { locales: 'fr-FR' });
// Restituisce: "dans 3 jours"

// Con numeric: 'auto' (predefinito)
gt.formatRelativeTime(-1, 'day', { locales: 'en-US' });
// Restituisce: "yesterday"
```

***

## Note

* Per impostazione predefinita, usa `numeric: 'auto'` e `style: 'long'`
* Si basa su [`Intl.RelativeTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat)

## Prossimi passaggi

* Vedi [`formatRelativeTimeFromDate`](/docs/core/class/methods/formatting/format-relative-time-from-date) per selezionare automaticamente l'unità a partire da un oggetto Date
* Vedi la funzione autonoma [`formatRelativeTime`](/docs/core/functions/formatting/format-relative-time) per l'uso senza un'istanza di GT