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/2025Todo el formateo se realiza localmente con la biblioteca Intl.DateTimeFormat.
Referencias
Props
Prop
Type
Descripción
| Prop Name | Descripción | 
|---|---|
| children | El 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. | 
| value | El valor predeterminado de la fecha u hora. Puede ser una cadena, un número (timestamp) o un objeto Date. | 
| options | Opciones 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. | 
| locales | Locales 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.
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.
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>.
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.
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.DateTimeFormatpara 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?

