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/2025Todo el formato se gestiona localmente con la biblioteca Intl.DateTimeFormat.
Referencias
Props
Prop
Type
Descripción
| Nombre de la prop | Descripción | 
|---|---|
| children | El contenido que se renderiza dentro del componente. Normalmente una fecha u hora. Si se proporciona, tiene prioridad sobre la prop value. | 
| value | El valor predeterminado para la fecha u hora. Puede ser una cadena, un número (timestamp) o un objeto Date. | 
| options | Opciones 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. | 
| locales | Locales 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.
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.
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>.
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.
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.DateTimeFormatpara 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?

