CKTIS / JavaScript
Tijdzones en uurcycli in Intl.DateTimeFormat
`timeZone` bepaalt welke lokale tijd bij een tijdstip wordt getoond. `hourCycle` bepaalt hoe het uur wordt genummerd, bijvoorbeeld of middernacht als `00` of `24` verschijnt.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })timeZone kiest de tijdzone waarin een tijdstip wordt weergegeven, zonder het Date-object of de opgeslagen waarde te wijzigen. Zonder deze optie gebruikt de formatter de standaardtijdzone van de uitvoeromgeving. Een benoemde zone zoals "America/New_York" volgt de regels die op dat tijdstip gelden, inclusief zomertijdwisselingen. Een vaste UTC-afwijking zoals "-05:00" volgt die regels niet. Oudere uitvoeromgevingen ondersteunen zulke afwijkingsaanduidingen mogelijk niet. timeZoneName bepaalt het weergegeven label, niet de gekozen zone.
hourCycle bepaalt het urenbereik: "h11" is 0–11, "h12" is 1–12, "h23" is 0–23 en "h24" is 1–24. In "h24" staat 24 voor het uur dat om middernacht begint; het tijdstip schuift niet door naar de volgende dag. hourCycle voegt uit zichzelf geen uur toe: vraag erom met hour of timeStyle, maar combineer die opties niet.
hour12: true en hour12: false hebben voorrang op zowel hourCycle als de Unicode-extensie hc van de locale. true kiest een cyclus van 12 uur, false een van 24 uur. Wil je een specifieke cyclus afdwingen, laat hour12 dan weg en stel hourCycle in; die optie heeft voorrang op hc. Zonder deze instellingen bepaalt de locale de standaardcyclus.
Een ongeldige hourCycle of een niet-herkende timeZone-aanduiding veroorzaakt een RangeError bij het maken van de formatter, ook als een geldige hour12 voorrang zou hebben op hourCycle. Controleer de effectieve instellingen met resolvedOptions(); de cyclus ontbreekt als de notatie geen uur bevat. Haal alleen het uur op via het hour-onderdeel van formatToParts() in plaats van de hele gelokaliseerde tekenreeks te ontleden.
Voorbeelden
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");Resultaat
UTC h23: 05 America/New_York h23: 00 America/New_York h24: 24
In de eerste twee regels verandert alleen de zone: hetzelfde tijdstip valt in uur `05` in UTC en om middernacht in New York. In de laatste regel verandert alleen de cyclus, zodat hetzelfde lokale uur als `24` in plaats van `00` wordt weergegeven.
Gerelateerde lessen
- JavaScript · Les 25 · Gevorderd · Versie: 4
Bronnen
- 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