WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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