CKTIS / JavaScript
Časovni pasovi in urni cikli v Intl.DateTimeFormat
`timeZone` določa, kateri krajevni čas se prikaže za dani trenutek. `hourCycle` določa številčenje ur, na primer ali se polnoč prikaže kot `00` ali `24`.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })timeZone izbere pas za prikaz trenutka, ne da bi spremenil objekt Date ali njegovo shranjeno vrednost. Če možnosti ne podaš, se uporabi privzeti pas izvajalnega okolja. Poimenovani pas, kot je "America/New_York", upošteva pravila, ki veljajo v danem trenutku, vključno s prehodi na poletni čas in nazaj. Fiksni odmik, kot je "-05:00", teh pravil ne upošteva. Starejša izvajalna okolja morda ne podpirajo identifikatorjev odmika. timeZoneName določa prikazano oznako, ne izbire pasu.
hourCycle določa razpon ur: "h11" uporablja 0–11, "h12" 1–12, "h23" 0–23 in "h24" 1–24. Pri "h24" številka 24 označuje uro, ki se začne ob polnoči; trenutka ne premakne na naslednji dan. hourCycle sam ne doda ure v izpis: zahtevaj jo z hour ali timeStyle, vendar možnosti ne združuj.
hour12: true in hour12: false imata prednost pred hourCycle in razširitvijo Unicode hc v identifikatorju jezikovnih in območnih nastavitev. true izbere 12-urni cikel, false pa 24-urnega. Za točno določen cikel izpusti hour12 in nastavi hourCycle, ki ima prednost pred hc. Brez teh nastavitev privzeti cikel določajo jezikovne in območne nastavitve.
Neveljaven hourCycle ali neprepoznan identifikator timeZone ob ustvarjanju oblikovalnika sproži RangeError, tudi če bi veljaven hour12 prevladal nad hourCycle. Dejanske nastavitve preveri z resolvedOptions(); če oblika ne vsebuje ure, cikel ni naveden. Samo uro pridobi iz dela hour v rezultatu formatToParts(), namesto da razčlenjuješ celoten lokalizirani niz.
Primeri
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
V prvih dveh vrsticah se spremeni samo pas: isti trenutek je v UTC v uri `05`, v New Yorku pa je polnoč. V zadnji vrstici se spremeni samo cikel, zato se ista krajevna ura prikaže kot `24` namesto `00`.
Povezane lekcije
- JavaScript · Lekcija 25 · Napredna · Različica: 4
Viri
- 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