CKTIS / JavaScript
Zeitzonen und Stundenzyklen in Intl.DateTimeFormat
`timeZone` bestimmt, welche Ortszeit für einen Zeitpunkt angezeigt wird. `hourCycle` bestimmt die Stundenzählung, etwa ob Mitternacht als `00` oder `24` erscheint.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })timeZone wählt die Zeitzone für die Anzeige eines Zeitpunkts, ohne das Date-Objekt oder seinen gespeicherten Wert zu ändern. Ohne die Option gilt die Standardzeitzone der Laufzeitumgebung. Eine benannte Zone wie "America/New_York" berücksichtigt die zum Zeitpunkt geltenden Regeln einschließlich der Sommerzeitumstellungen. Ein fester UTC-Versatz wie "-05:00" folgt diesen Regeln nicht. Ältere Laufzeitumgebungen unterstützen solche Versatzbezeichner möglicherweise nicht. timeZoneName steuert die angezeigte Beschriftung, nicht die Wahl der Zone.
hourCycle legt den Stundenbereich fest: "h11" steht für 0–11, "h12" für 1–12, "h23" für 0–23 und "h24" für 1–24. Bei "h24" bezeichnet 24 die um Mitternacht beginnende Stunde; der Zeitpunkt wird nicht auf den nächsten Tag verschoben. hourCycle fügt der Ausgabe keine Stunde hinzu. Fordere sie über hour oder timeStyle an, aber kombiniere die beiden Optionen nicht.
hour12: true und hour12: false haben Vorrang vor hourCycle und der Unicode-Erweiterung hc der Locale. true wählt einen 12-Stunden-Zyklus, false einen 24-Stunden-Zyklus. Für einen bestimmten Zyklus lass hour12 weg und setze hourCycle; diese Option hat Vorrang vor hc. Ohne diese Einstellungen bestimmt die Locale den Standardzyklus.
Ein ungültiger Wert für hourCycle oder ein unbekannter timeZone-Bezeichner löst beim Erstellen des Formatierers einen RangeError aus, auch wenn ein gültiges hour12 den Wert von hourCycle übersteuern würde. Prüfe die effektiven Einstellungen mit resolvedOptions(); der Zyklus fehlt, wenn das Format keine Stunde enthält. Lies nur die Stunde über den hour-Teil von formatToParts() aus, statt die gesamte lokalisierte Zeichenkette zu zerlegen.
Beispiele
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");Ergebnis
UTC h23: 05 America/New_York h23: 00 America/New_York h24: 24
In den ersten beiden Zeilen ändert sich nur die Zeitzone: Derselbe Zeitpunkt liegt in UTC in Stunde `05` und in New York um Mitternacht. In der letzten Zeile ändert sich nur der Zyklus, sodass dieselbe Ortsstunde als `24` statt `00` erscheint.
Zugehörige Lektionen
- JavaScript · Lektion 25 · Fortgeschritten · Version: 4
Quellen
- 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