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
- ECMAScript® 2027 Internationalization API Specification
- ECMAScript® 2024 Internationalization API Specification
- ECMAScript® 2026 Internationalization API Specification
- Official reference — tc39.es: ecma402
- Official reference — tc39.es: ecma402
- Official reference — developer.mozilla.org: Intl / DateTimeFormat