CKTIS / JavaScript
Intl.DateTimeFormat — lokalizirano oblikovanje datuma in časa
Intl.DateTimeFormat oblikuje datume in čase v skladu z lokalnimi konvencijami in izbranim časovnim pasom. Spoznajte format(), formatToParts(), resolvedOptions() ter razliko med timeZone in hourCycle.
Različica: 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 je del internacionalizacijskega standarda ECMA-402, ne DOM API-ja. Ustvarite formatter z new Intl.DateTimeFormat(locales, options) in ga uporabljajte večkrat. Locale določa pravila prikaza; ne izbere samodejno časovnega pasu, ki ustreza določeni državi.
Imeni Intl.DateTimeFormat.format in Intl.DateTimeFormat.formatToParts tukaj pomenita operaciji na primerku, ne statičnih metod konstruktorja. formatter.format(date) vrne besedilo; lastnost format je dostopnik, ki zagotovi vezano funkcijo. formatter.formatToParts(date) vrne urejene objekte { type, value }, vključno z deli literal. S povezovanjem vseh vrednosti value ponovno sestavite format(date). Lokaliziranega besedila ne razčlenjujte z deljenjem po ločilih.
timeZone, na primer UTC ali Europe/Warsaw, izbere pas za prikaz istega trenutka, ne da bi spremenil objekt Date. Če možnost izpustite, se uporabi časovni pas okolja. hourCycle določa razpon ur: h11 je 0–11, h12 1–12, h23 0–23 in h24 1–24. Pomemben je pri oblikovanju ur; če je podana možnost hour12, ima prednost.
Intl.DateTimeFormat.prototype.resolvedOptions, poklican kot formatter.resolvedOptions(), razkrije dejansko izbrane nastavitve, med njimi locale, timeZone in, kadar oblika vključuje ure, hourCycle. Lokalni podatki se lahko med okolji razlikujejo, zato ne predpostavljajte enakega ločenja z ločili ali presledkov. Standard ni tabela združljivosti brskalnikov: zahtevane metode in možnosti preverite v ciljnih okoljih; Node 24 ne dokazuje podpore v brskalnikih.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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