# generaltranslation: General Translation Core SDK: formatRelativeTimeFromDate
URL: https://generaltranslation.com/es/docs/core/class/methods/formatting/format-relative-time-from-date.mdx
---
title: formatRelativeTimeFromDate
description: Referencia de la API del método formatRelativeTimeFromDate para dar formato al tiempo relativo a partir de un objeto Date
---

## Descripción general

El método `formatRelativeTimeFromDate` formatea una cadena de tiempo relativo a partir de un objeto `Date` y selecciona automáticamente la unidad más adecuada.

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


## Referencia

### Parámetros

| Nombre     | Tipo     | Descripción                                              |
| ---------- | -------- | -------------------------------------------------------- |
| `date`     | `Date`   | La fecha que se va a formatear con respecto a `baseDate` |
| `options?` | `object` | Configuración del formato                                |

### Opciones

| Nombre           | Tipo                            | Descripción                                                                                                                        |
| ---------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `locales?`       | `string \| string[]`            | Configuraciones regionales para el formato. Si no se especifica, usa las configuraciones regionales de renderizado de la instancia |
| `baseDate?`      | `Date`                          | La fecha base para la comparación. El valor predeterminado es `new Date()`                                                         |
| `numeric?`       | `'always' \| 'auto'`            | Indica si siempre se debe usar una salida numérica. El valor predeterminado es `'auto'`                                            |
| `style?`         | `'long' \| 'short' \| 'narrow'` | La longitud de la salida. El valor predeterminado es `'long'`                                                                      |
| `localeMatcher?` | `'best fit' \| 'lookup'`        | El algoritmo de coincidencia de configuración regional que se debe usar                                                            |

### Devuelve

`cadena` - La cadena de tiempo relativo con formato (p. ej., "hace 2 horas", "en 3 días").

***

## Ejemplo

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

const now = new Date();

// Selecciona automáticamente "hours"
const twoHoursAgo = new Date(now.getTime() - 7200000);
gt.formatRelativeTimeFromDate(twoHoursAgo, { locales: 'en-US', baseDate: now });
// Devuelve: "2 hours ago"

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

***

## Notas

* Selecciona automáticamente la unidad más adecuada según la diferencia de tiempo
* Usa por defecto `numeric: 'auto'` y `style: 'long'`
* Si no se proporciona `baseDate`, el valor predeterminado es `new Date()`

## Siguientes pasos

* Consulta [`formatRelativeTime`](/docs/core/class/methods/formatting/format-relative-time) para dar formato explícito a valores + unidades
* Consulta la función autónoma [`formatRelativeTimeFromDate`](/docs/core/functions/formatting/format-relative-time-from-date) para usarla sin una instancia de GT