# generaltranslation: General Translation Core SDK: formatRelativeTime
URL: https://generaltranslation.com/it/docs/core/functions/formatting/format-relative-time.mdx
---
title: formatRelativeTime
description: Funzione autonoma per formattare valori di tempo relativo in base alle convenzioni locali
---

## Panoramica

La funzione autonoma `formatRelativeTime` formatta un valore di tempo relativo con un'unità esplicita, secondo le convenzioni specifiche dell'impostazione regionale, senza richiedere un'istanza di GT.

```typescript
import { formatRelativeTime } from 'generaltranslation';

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


## Riferimento

### Parametri

| Nome      | Tipo                          | Descrizione                                                                                     |
| --------- | ----------------------------- | ----------------------------------------------------------------------------------------------- |
| `value`   | `number`                      | Il valore di tempo 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[]`            | **Obbligatorio.** Impostazioni regionali per il formataggio             |
| `numeric?`       | `'always' \| 'auto'`            | 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 regionali da usare |

### Restituisce

`string` - La stringa del tempo relativo formattata.

***

## Esempio

### Utilizzo di base

```typescript copy
import { formatRelativeTime } from 'generaltranslation';

// Tempo passato
console.log(formatRelativeTime(-2, 'hour', { locales: 'en-US' }));
// Output: "2 ore fa"

// Tempo futuro
console.log(formatRelativeTime(3, 'day', { locales: 'en-US' }));
// Output: "tra 3 giorni"

// Con numeric: 'auto' (predefinito)
console.log(formatRelativeTime(-1, 'day', { locales: 'en-US' }));
// Output: "ieri"
```


### Stili di formattazione

```typescript copy
import { formatRelativeTime } from 'generaltranslation';

// Stile lungo (predefinito)
console.log(formatRelativeTime(-2, 'day', {
  locales: 'en-US',
  style: 'long'
}));
// Output: "2 days ago"

// Stile breve
console.log(formatRelativeTime(-2, 'day', {
  locales: 'en-US',
  style: 'short'
}));
// Output: "2 days ago" (può essere abbreviato in alcune impostazioni regionali)

// Stile compatto
console.log(formatRelativeTime(-2, 'day', {
  locales: 'en-US',
  style: 'narrow'
}));
// Output: "2d ago"
```


### Impostazioni regionali multiple

```typescript copy
import { formatRelativeTime } from 'generaltranslation';

const locales = ['en-US', 'fr-FR', 'ja-JP', 'de-DE'];

locales.forEach(locale => {
  console.log(`${locale}: ${formatRelativeTime(-3, 'hour', { locales: locale })}`);
});
// Output:
// en-US: 3 hours ago
// fr-FR: il y a 3 heures
// ja-JP: 3 時間前
// de-DE: vor 3 Stunden
```

***


## Note

* Per impostazione predefinita, usa `numeric: 'auto'` e `style: 'long'`
* Con `numeric: 'auto'`, valori come `-1 day` producono "ieri" invece di "1 giorno fa"
* Usa [`Intl.RelativeTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat) internamente
* I risultati vengono memorizzati internamente nella cache per migliorare le prestazioni con combinazioni ricorrenti di impostazione regionale e opzioni

## Passaggi successivi

* Vedi [`formatRelativeTimeFromDate`](/docs/core/functions/formatting/format-relative-time-from-date) per selezionare automaticamente l'unità a partire da un oggetto Date
* Vedi [`formatDateTime`](/docs/core/functions/formatting/format-date-time) per la formattazione autonoma di data e ora
* Vedi il metodo [`formatRelativeTime`](/docs/core/class/methods/formatting/format-relative-time) della classe GT per l'uso tramite istanza