# generaltranslation: General Translation Core SDK: formatRelativeTimeFromDate
URL: https://generaltranslation.com/fr/docs/core/class/methods/formatting/format-relative-time-from-date.mdx
---
title: formatRelativeTimeFromDate
description: Référence API de la méthode formatRelativeTimeFromDate pour formater un temps relatif à partir d’un objet Date
---

## Vue d’ensemble

La méthode `formatRelativeTimeFromDate` formate une chaîne de caractères exprimant un temps relatif à partir d’un objet `Date`, en sélectionnant automatiquement l’unité la plus appropriée.

```typescript
const gt = new GT();
const pastDate = new Date(Date.now() - 7200000); // il y a 2 heures
const formatted = gt.formatRelativeTimeFromDate(pastDate, {
  locales: 'en-US'
});
// Retourne : "2 hours ago"
```


## Référence

### Paramètres

| Nom        | Type     | Description                                 |
| ---------- | -------- | ------------------------------------------- |
| `date`     | `Date`   | La date à formater par rapport à `baseDate` |
| `options?` | `object` | Configuration du formatage                  |

### Options

| Nom              | Type                            | Description                                                                                                             |
| ---------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `locales?`       | `string \| string[]`            | Paramètres régionaux utilisés pour le formatage. Utilise par défaut les paramètres régionaux de rendu de l'instance |
| `baseDate?`      | `Date`                          | Date de base pour la comparaison. Par défaut : `new Date()`                                                             |
| `numeric?`       | `'always' \| 'auto'`            | Indique s'il faut toujours utiliser une sortie numérique. Valeur par défaut : `'auto'`                              |
| `style?`         | `'long' \| 'short' \| 'narrow'` | Longueur de la sortie. Valeur par défaut : `'long'`                                                                     |
| `localeMatcher?` | `'best fit' \| 'lookup'`        | Algorithme de correspondance des paramètres régionaux à utiliser                                                        |

### Renvoie

`chaîne de caractères` - La chaîne de caractères de temps relatif formatée (par ex. : "il y a 2 heures", "dans 3 jours").

***

## Exemple

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

const now = new Date();

// Sélectionne automatiquement "hours"
const twoHoursAgo = new Date(now.getTime() - 7200000);
gt.formatRelativeTimeFromDate(twoHoursAgo, { locales: 'en-US', baseDate: now });
// Retourne : "2 hours ago"

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

***

## Remarques

* Sélectionne automatiquement l’unité la plus appropriée en fonction de l’écart de temps
* Utilise par défaut `numeric: 'auto'` et `style: 'long'`
* Si `baseDate` n’est pas fourni, la valeur par défaut est `new Date()`

## Étapes suivantes

* Voir [`formatRelativeTime`](/docs/core/class/methods/formatting/format-relative-time) pour le formatage explicite d’une valeur et d’une unité
* Voir la fonction autonome [`formatRelativeTimeFromDate`](/docs/core/functions/formatting/format-relative-time-from-date) pour l’utiliser sans instance GT