CKTIS / JavaScript
Vremenske zone i ciklusi sati u Intl.DateTimeFormat
`timeZone` bira lokalno vrijeme koje se prikazuje za zadani trenutak. `hourCycle` određuje numeriranje sati, primjerice prikazuje li se ponoć kao `00` ili `24`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })timeZone bira zonu za prikaz trenutka, bez promjene objekta Date ili njegove pohranjene vrijednosti. Ako izostaviš tu opciju, koristi se zadana zona izvršnog okruženja. Imenovana zona kao što je "America/New_York" primjenjuje pravila koja vrijede u tom trenutku, uključujući prijelaze na ljetno računanje vremena i natrag. Fiksni pomak kao što je "-05:00" ne slijedi ta pravila. Starija okruženja možda ne podržavaju identifikatore pomaka. timeZoneName određuje prikazanu oznaku, a ne odabir zone.
hourCycle određuje raspon sati: "h11" koristi 0–11, "h12" 1–12, "h23" 0–23, a "h24" 1–24. U ciklusu "h24" broj 24 označava sat koji počinje u ponoć; ne pomiče trenutak na sljedeći dan. Sam hourCycle ne dodaje sat u izlaz: zatraži ga opcijom hour ili timeStyle, ali nemoj kombinirati te dvije opcije.
hour12: true i hour12: false imaju prednost pred opcijom hourCycle i proširenjem Unicode hc u identifikatoru regionalnih postavki. true bira 12-satni, a false 24-satni ciklus. Za točno određen ciklus izostavi hour12 i postavi hourCycle, koji ima prednost pred hc. Bez tih postavki zadani ciklus ovisi o regionalnim postavkama.
Nevaljan hourCycle ili neprepoznat identifikator timeZone uzrokuje RangeError pri stvaranju formatera, čak i ako bi valjani hour12 imao prednost pred hourCycle. Provjeri primijenjene postavke metodom resolvedOptions(); ciklus nije naveden ako format ne sadrži sat. Za izdvajanje samo sata uzmi dio hour iz rezultata metode formatToParts() umjesto raščlanjivanja cijelog lokaliziranog niza.
Primjeri
const instant = new Date("2024-01-15T05:00:00Z");
function showHour(timeZone, hourCycle) {
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone,
hourCycle,
hour: "2-digit",
numberingSystem: "latn",
formatMatcher: "basic",
});
const hour = formatter.formatToParts(instant).find(part => part.type === "hour");
const displayHour = hour.value.padStart(2, "0");
console.log(`${timeZone} ${formatter.resolvedOptions().hourCycle}: ${displayHour}`);
}
showHour("UTC", "h23");
showHour("America/New_York", "h23");
showHour("America/New_York", "h24");Rezultat
UTC h23: 05 America/New_York h23: 00 America/New_York h24: 24
U prva se dva retka mijenja samo zona: isti trenutak odgovara satu `05` u UTC-u i ponoći u New Yorku. U posljednjem se retku mijenja samo ciklus pa se isti lokalni sat prikazuje kao `24` umjesto `00`.
Povezane lekcije
- JavaScript · Lekcija 25 · Napredno · Verzija: 4
Izvori
- ECMAScript® 2024 Internationalization API Specification — CreateDateTimeFormat
- ECMAScript Internationalization API Specification — CreateDateTimeFormat (living specification)
- Intl.DateTimeFormat() constructor — MDN
- Intl.DateTimeFormat.prototype.resolvedOptions() — MDN
- Intl.DateTimeFormat.prototype.formatToParts() — MDN