Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Intl.DateTimeFormat — formattazione localizzata di date e orari

Intl.DateTimeFormat formatta date e orari secondo le convenzioni locali e un fuso orario selezionato. Scopri format(), formatToParts(), resolvedOptions() e la differenza tra timeZone e hourCycle.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();

Intl.DateTimeFormat fa parte dello standard di internazionalizzazione ECMA-402, non dell’API DOM. Crea un formatter con new Intl.DateTimeFormat(locales, options) e riutilizzalo. Una locale determina le convenzioni di presentazione; non seleziona automaticamente il fuso orario corrispondente a quel paese.

I nomi Intl.DateTimeFormat.format e Intl.DateTimeFormat.formatToParts indicano qui operazioni di istanza, non metodi statici del costruttore. formatter.format(date) restituisce testo; la proprietà format è un accessor che fornisce una funzione associata. formatter.formatToParts(date) restituisce oggetti { type, value } ordinati, incluse le parti literal. Unendo tutti i valori value si ricostruisce format(date). Non analizzare il testo localizzato dividendolo in corrispondenza dei separatori.

timeZone, ad esempio UTC o Europe/Warsaw, seleziona il fuso usato per visualizzare lo stesso istante, senza modificare l’oggetto Date. Se l’opzione è omessa, viene usato il fuso orario dell’ambiente. hourCycle seleziona l’intervallo delle ore: h11 è 0–11, h12 è 1–12, h23 è 0–23 e h24 è 1–24. È rilevante quando si formattano le ore; se specificata, l’opzione hour12 ha la precedenza.

Intl.DateTimeFormat.prototype.resolvedOptions, chiamato come formatter.resolvedOptions(), espone le impostazioni effettivamente selezionate, tra cui locale, timeZone e, quando il formato include le ore, hourCycle. I dati locali possono variare tra ambienti, quindi non presumere che punteggiatura o spaziatura siano identiche. Lo standard non è una tabella di compatibilità dei browser: verifica i metodi e le opzioni necessari negli ambienti di destinazione; Node 24 non dimostra il supporto nei browser.

Esempi

const formatter = new Intl.DateTimeFormat('en-GB', {
  timeZone: 'UTC',
  numberingSystem: 'latn',
  hour: '2-digit',
  minute: '2-digit',
  hourCycle: 'h23'
});
const date = new Date('2024-01-02T00:05:00Z');
const parts = formatter.formatToParts(date);
const field = type => parts.find(part => part.type === type).value;
console.log(`${field('hour')}:${field('minute')}`);
console.log(parts.map(part => part.value).join('') === formatter.format(date));
console.log(formatter.resolvedOptions().hourCycle);

Risultato

00:05
true
h23

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti