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/2025Todo el formateo 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, un valor de fecha u hora. Si se proporciona, tiene prioridad sobre la prop value. |
value | El valor por defecto para la fecha u hora. Puede ser una cadena, un número (timestamp) o un objeto Date. |
options | Opciones 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. |
locales | Conjunto 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.
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>.
);
}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>.
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.
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.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 parece esta guía?