DateTime
Riferimento API del componente <DateTime>
Panoramica
Il componente <DateTime> visualizza una stringa di data o ora formattata e supporta personalizzazioni come le opzioni di formattazione e il locale.
La data o l’ora vengono formattate in base al locale corrente e a eventuali parametri facoltativi.
<DateTime>{1738010355}</DateTime>
// Output: 27/1/2025Tutta la formattazione viene gestita localmente tramite la libreria Intl.DateTimeFormat.
Riferimenti
Proprietà
Prop
Type
Descrizione
| Nome prop | Descrizione |
|---|---|
children | Il contenuto da renderizzare all'interno del componente, tipicamente un valore di data o ora. Se presente, ha precedenza sulla prop value. |
value | Il valore predefinito per la data o l'ora. Può essere una stringa, un numero (timestamp) o un oggetto Date. |
options | Opzioni facoltative di formattazione per la data o l'ora, secondo la specifica Intl.DateTimeFormatOptions. Usale per definire aspetti come i nomi dei giorni della settimana, i fusi orari e altro. |
locales | Locali facoltativi per specificare la lingua/locale di formattazione. Se non forniti, viene utilizzata la lingua/locale dell'utente. Ulteriori informazioni su come specificare le locali qui. |
Restituisce
JSX.Element che contiene la data o l’ora formattata come stringa.
Esempi
Utilizzo di base
Il componente <DateTime> può essere utilizzato per visualizzare valori di data o ora localizzati.
import { DateTime } from 'gt-next';
export default function EventDate(event) {
return (
<DateTime> {event.date} </DateTime>.
);
}Specificare le impostazioni locali
Il componente <DateTime> può essere utilizzato per visualizzare valori di data o ora in impostazioni locali specifiche.
import { DateTime } from 'gt-next';
export default function EventDate(event) {
return (
<DateTime locales={['fr-FR']}> {event.date} </DateTime>.
);
}Tradurre <DateTime>
Supponiamo che tu voglia visualizzare data e ora all’interno di una frase che viene tradotta.
Puoi racchiudere il componente <DateTime> nel componente <T>.
import { T, DateTime } from 'gt-next';
export default function EventDate(event) {
return (
<T id="eventDate">
La data dell'evento è <DateTime> {event.date} </DateTime>. // [!code highlight]
</T>
);
}Formattazione personalizzata
Il componente <DateTime> supporta formati personalizzati.
import { DateTime } from 'gt-next';
export default function EventDate(event) {
return (
<DateTime options={{
dateStyle: 'full',
timeStyle: 'long',
timeZone: 'Australia/Sydney',
}}>
{event.date}
</DateTime>.
);
}Note
- Il componente
<DateTime>è un componente variabile utilizzabile per formattare valori di data e ora. - Il componente usa la libreria
Intl.DateTimeFormatper la formattazione.
Prossimi passaggi
- Per maggiori dettagli ed esempi di utilizzo del componente
<DateTime>e di altri componenti variabili come<Currency>,<Num>e<Var>,
Come valuti questa guida?