CKTIS / JavaScript
Intl.DateTimeFormat — lokalizirano oblikovanje datuma i vremena
Intl.DateTimeFormat oblikuje datume i vremena prema lokalnim konvencijama i odabranoj vremenskoj zoni. Saznajte više o format(), formatToParts(), resolvedOptions() i razlici između timeZone i hourCycle.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();Intl.DateTimeFormat dio je standarda internacionalizacije ECMA-402, a ne DOM API-ja. Izradite formatter pomoću new Intl.DateTimeFormat(locales, options) i ponovno ga upotrebljavajte. Locale određuje konvencije prikaza; ne odabire automatski vremensku zonu koja odgovara toj zemlji.
Nazivi Intl.DateTimeFormat.format i Intl.DateTimeFormat.formatToParts ovdje označavaju operacije instance, a ne statičke metode konstruktora. formatter.format(date) vraća tekst; svojstvo format pristupnik je koji izlaže povezanu funkciju. formatter.formatToParts(date) vraća poredane objekte { type, value }, uključujući dijelove literal. Spajanjem svih vrijednosti value ponovno se dobiva format(date). Lokalizirani tekst nemojte parsirati dijeljenjem prema razdjelnicima.
timeZone, primjerice UTC ili Europe/Warsaw, odabire zonu za prikaz istog trenutka bez promjene objekta Date. Ako izostavite tu opciju, upotrebljava se vremenska zona okruženja. hourCycle određuje raspon sati: h11 je 0–11, h12 1–12, h23 0–23, a h24 1–24. Važan je pri oblikovanju sati; ako je navedena opcija hour12, ona ima prednost.
Intl.DateTimeFormat.prototype.resolvedOptions, pozvan kao formatter.resolvedOptions(), otkriva stvarno odabrane postavke, uključujući locale, timeZone i, kada format uključuje sate, hourCycle. Lokalizacijski se podaci mogu razlikovati među okruženjima, stoga nemojte pretpostaviti jednaku interpunkciju ili razmake. Standard nije tablica kompatibilnosti preglednika: provjerite potrebne metode i opcije u ciljnim okruženjima; Node 24 ne dokazuje podršku u preglednicima.
Primjeri
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);Rezultat
00:05 true h23
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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