Components

DateTime

Referencia de API del componente <DateTime>

Descripción general

El componente <DateTime> muestra una cadena de fecha u hora formateada y admite personalización, como options de formato y locale. La fecha u hora se formatea según el locale actual y los parámetros opcionales proporcionados.

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

Todo el formateo 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, un valor de fecha u hora. Si se proporciona, tiene prioridad sobre la prop value.
valueEl valor por defecto para la fecha u hora. Puede ser una cadena, un número (timestamp) o un objeto Date.
optionsOpciones de formato 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.
localesConjunto de locales opcional para especificar la configuración regional de formato. Si no se proporciona, se usa la configuración regional del usuario. Lee más sobre cómo especificar locales aquí.

Devuelve

JSX.Element que contiene la fecha o la hora con formato como cadena.


Ejemplos

Uso básico

El componente <DateTime> se puede utilizar para mostrar valores de fecha u hora localizados.

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>. 
    );
}

Traducir <DateTime>

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

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

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

Formateo personalizado

El componente <DateTime> admite options 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 utilizarse 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 parece esta guía?