Components

DateTime

Referencia de API del componente <DateTime>

Descripción general

El componente <DateTime> renderiza 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 la locale actual y cualquier parámetro opcional proporcionado.

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

Todo el formateo se realiza localmente con la biblioteca Intl.DateTimeFormat.

Referencias

Props

Prop

Type

Descripción

Prop NameDescripción
childrenEl contenido que se renderiza dentro del componente. Por lo general, un valor de fecha u hora. Si se proporciona, tiene prioridad sobre la prop value.
valueEl valor predeterminado de la fecha u hora. Puede ser una cadena, un número (timestamp) o un objeto Date.
optionsOpciones de formato (opcionales) para la fecha u hora, según la especificación de 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 formato. 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 una cadena.


Ejemplos

Uso básico

El componente <DateTime> puede usarse para mostrar fechas u horas con formato local.

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

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-react';

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

Traducir <DateTime>

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

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

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

Formato personalizado

El componente <DateTime> admite options de formato personalizadas.

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

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 de variables que puede usarse para formatear valores de fecha y hora.
  • El componente utiliza la biblioteca Intl.DateTimeFormat para el formateo.

Próximos pasos

  • Para obtener 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