Components

DateTime

Referencia de API del componente <DateTime>

Descripción general

El componente <DateTime> muestra una cadena de fecha u hora formateada y permite personalización mediante opciones de formato y el locale. La fecha u hora se formatea según el locale actual y cualquier parámetro opcional proporcionado.

<DateTime>{1738010355}</DateTime>
// Resultado: 27/1/2025

Todo el formato se gestiona localmente con la biblioteca Intl.DateTimeFormat.

Referencias

Props

Prop

Type

Descripción

Nombre de la propDescripción
childrenEl contenido que se renderiza dentro del componente. Normalmente una fecha u hora. Si se proporciona, tiene prioridad sobre la prop value.
valueEl valor predeterminado para la fecha u hora. Puede ser una cadena, un número (timestamp) o un objeto Date.
optionsOpciones de formateo opcionales para la fecha u hora, siguiendo la especificación Intl.DateTimeFormatOptions. Úsalo para definir estilos como nombres de días de la semana, zonas horarias y más.
localesLocales opcionales para especificar el locale de formateo. Si no se proporciona, se usa el locale del usuario. Lee más sobre cómo especificar locales aquí.

Devuelve

JSX.Element que contiene la fecha u hora formateada como cadena.


Ejemplos

Uso básico

El componente <DateTime> se puede usar para mostrar valores de fecha u hora con formato localizado.

EventDate.jsx
import { DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <DateTime>{event.date}</DateTime> 
    );
}

Especificar locales

El componente <DateTime> se puede usar para mostrar valores de fecha u hora en un locale específico.

EventDate.jsx

import { DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <DateTime locales={['fr-FR']}> {event.date} </DateTime>. 
    );
}

Traducción de <DateTime>

Supongamos que quieres que la fecha y hora se muestren dentro de una oración que también se está traduciendo. Puedes envolver el componente <DateTime> con un componente <T>.

EventDate.jsx
import { T, DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <T id="eventDate">
            La hora del evento es <DateTime> {event.date} </DateTime>. // [!code highlight]
        </T>
    );
}

Formato personalizado

El componente <DateTime> admite opciones de formateo personalizadas.

EventDate.jsx
import { DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <DateTime options={{
            dateStyle: 'full', 
            timeStyle: 'long', 
            timeZone: 'Australia/Sydney', 
        }}>
            {event.date}
        </DateTime>.
    );
}

Notas

  • El componente <DateTime> es un componente variable que puede usarse para formatear valores de fecha y hora.
  • El componente utiliza la biblioteca Intl.DateTimeFormat para el formateo.

Próximos pasos

  • Para más detalles y ejemplos de uso del componente <DateTime> y de otros componentes de variables como <Currency>, <Num> y <Var>,

¿Qué te ha parecido esta guía?

DateTime