Components

DateTime

Riferimento API del componente <DateTime>

Panoramica

Il componente <DateTime> visualizza una stringa di data o ora formattata, con possibilità di personalizzazione come opzioni di formattazione e impostazioni locali. La data o l'ora viene formattata in base alle impostazioni locali correnti e a eventuali parametri opzionali forniti.

<DateTime>{1738010355}</DateTime>
// Output: 27/01/2025

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

Riferimenti

Props

Prop

Type

Descrizione

Nome propDescrizione
childrenIl contenuto da renderizzare all'interno del componente, in genere un valore di data o ora. Se presente, ha la 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 di formattazione opzionali per la data o l'ora, conformi alla specifica Intl.DateTimeFormatOptions. Usale per definire stili come nomi dei giorni della settimana, fusi orari e altro.
localesLocali opzionali per specificare la locale di formattazione. Se non fornita, verrà utilizzata la locale dell'utente. Scopri di più sulla specifica delle locali qui.

Restituisce

JSX.Element che contiene la data o l'ora formattata come stringa.


Esempi

Utilizzo di base

Il componente <DateTime> può essere usato per visualizzare date e orari localizzati.

EventDate.jsx
import { DateTime } from 'gt-react';

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 una specifica impostazione locale.

EventDate.jsx

import { DateTime } from 'gt-react';

export default function EventDate(event) {
    return (
        <DateTime locales={['fr-FR']}> {event.date} </DateTime>. 
    );
}

Tradurre <DateTime>

Mettiamo che tu voglia mostrare la data e l’ora all’interno di una frase che viene tradotta. Puoi racchiudere il componente <DateTime> nel componente <T>.

EventDate.jsx
import { T, DateTime } from 'gt-react';

export default function EventDate(event) {
    return (
        <T id="eventDate">
            L'orario dell'evento è <DateTime> {event.date} </DateTime>. // [!code highlight]
        </T>
    );
}

Formattazione personalizzata

Il componente <DateTime> supporta opzioni di formattazione personalizzate.

EventDate.jsx
import { DateTime } from 'gt-react';

export default function EventDate(event) {
    return (
        <DateTime options={{
            dateStyle: 'full', 
            timeStyle: 'long', 
            timeZone: 'Australia/Sydney', 
        }}>
            {event.date}
        </DateTime>.
    );
}

Note

  • Il componente <DateTime> è un componente dinamico che può essere utilizzato per formattare valori di data e ora.
  • Il componente usa la libreria Intl.DateTimeFormat per la formattazione.

Prossimi passaggi

  • Per ulteriori dettagli ed esempi d’uso del componente <DateTime> e di altri componenti di variabili come <Currency>, <Num> e <Var>,

Come valuti questa guida?

DateTime