# generaltranslation: General Translation Core SDK: formatRelativeTimeFromDate
URL: https://generaltranslation.com/it/docs/core/class/methods/formatting/format-relative-time-from-date.mdx
---
title: formatRelativeTimeFromDate
description: Riferimento API per il metodo formatRelativeTimeFromDate, che formatta il tempo relativo a partire da un oggetto Date
---

## Panoramica

Il metodo `formatRelativeTimeFromDate` formatta una stringa che rappresenta un tempo relativo a partire da un oggetto `Date`, selezionando automaticamente l'unità più adatta.

```typescript
const gt = new GT();
const pastDate = new Date(Date.now() - 7200000); // 2 ore fa
const formatted = gt.formatRelativeTimeFromDate(pastDate, {
  locales: 'en-US'
});
// Restituisce: "2 hours ago"
```


## Riferimento

### Parametri

| Nome       | Tipo     | Descrizione                                 |
| ---------- | -------- | ------------------------------------------- |
| `date`     | `Date`   | La data da formattare rispetto a `baseDate` |
| `options?` | `object` | Configurazione per la formattazione         |

### Opzioni

| Nome             | Tipo                            | Descrizione                                                                                                                 |
| ---------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `locales?`       | `string \| string[]`            | Impostazioni regionali per la formattazione. In caso contrario, usa le impostazioni regionali di rendering dell'istanza |
| `baseDate?`      | `Date`                          | La data di riferimento per il confronto. Per impostazione predefinita è `new Date()`                                        |
| `numeric?`       | `'always' \| 'auto'`            | Indica se usare sempre un output numerico. Per impostazione predefinita è `'auto'`                                          |
| `style?`         | `'long' \| 'short' \| 'narrow'` | La lunghezza dell'output. Per impostazione predefinita è `'long'`                                                       |
| `localeMatcher?` | `'best fit' \| 'lookup'`        | L'algoritmo di corrispondenza delle impostazioni regionali da usare                                                     |

### Restituisce

`string` - La stringa di tempo relativo formattata (ad esempio, "2 ore fa", "tra 3 giorni").

***

## Esempio

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

const now = new Date();

// Seleziona automaticamente "hours"
const twoHoursAgo = new Date(now.getTime() - 7200000);
gt.formatRelativeTimeFromDate(twoHoursAgo, { locales: 'en-US', baseDate: now });
// Restituisce: "2 hours ago"

// Seleziona automaticamente "days"
const threeDaysLater = new Date(now.getTime() + 259200000);
gt.formatRelativeTimeFromDate(threeDaysLater, { locales: 'fr-FR', baseDate: now });
// Restituisce: "dans 3 jours"
```

***

## Note

* Seleziona automaticamente l'unità più adatta in base alla differenza di tempo
* Per impostazione predefinita, usa `numeric: 'auto'` e `style: 'long'`
* Se `baseDate` non viene fornita, il valore predefinito è `new Date()`

## Passaggi successivi

* Vedi [`formatRelativeTime`](/docs/core/class/methods/formatting/format-relative-time) per formattare esplicitamente valore + unità
* Vedi la funzione autonoma [`formatRelativeTimeFromDate`](/docs/core/functions/formatting/format-relative-time-from-date) per usarla senza un'istanza di GT