Components

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/2025

Tutta la formattazione viene gestita localmente tramite la libreria Intl.DateTimeFormat.

Riferimenti

Proprietà

Prop

Type

Descrizione

Nome propDescrizione
childrenIl contenuto da renderizzare all'interno del componente, tipicamente un valore di data o ora. Se presente, ha precedenza sulla prop value.
valueIl valore predefinito per la data o l'ora. Può essere una stringa, un numero (timestamp) o un oggetto Date.
optionsOpzioni 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.
localesLocali 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.

EventDate.jsx
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.

EventDate.jsx

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>.

EventDate.jsx
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.

EventDate.jsx
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.DateTimeFormat per 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?

DateTime