Intl.Locale.prototype.hourCycle

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Die hourCycle Zugriffs-Eigenschaft von Intl.Locale Instanzen gibt den Typ des Stundenzyklus für diese Locale zurück.

Beschreibung

Es gibt zwei Haupttypen von Zeitmessungs-Konventionen (Uhren), die weltweit verwendet werden: die 12-Stunden-Uhr und die 24-Stunden-Uhr. Für eine Liste der unterstützten Stundenzyklustypen siehe Intl.Locale.prototype.getHourCycles().

Der Wert der hourCycle Eigenschaft wird zum Zeitpunkt der Konstruktion festgelegt, entweder über den hc Schlüssel des Locale-Bezeichners oder über die hourCycle Option des Intl.Locale() Konstruktors. Letzterer hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

Der set Accessor von hourCycle ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Locale-Subtags kann der Stundenzyklustyp dem Intl.Locale Objekt über den Locale-String oder ein Konfigurationsobjekt-Argument des Konstruktors hinzugefügt werden.

Hinzufügen eines Stundenzyklus über den Locale-String

In der Unicode Locale-String-Spezifikation ist hourCycle ein "Erweiterungs-Subtag". Diese Subtags fügen zusätzliche Daten über die Locale hinzu und werden zu Locale-Bezeichnern unter Verwendung des -u Erweiterungsschlüssels hinzugefügt. Um den Stundenzyklustyp dem initialen Locale-Bezeichner-String hinzuzufügen, der in den Intl.Locale() Konstruktor übergeben wird, fügen Sie zuerst den -u Erweiterungsschlüssel hinzu, falls er nicht vorhanden ist. Fügen Sie als nächstes die -hc Erweiterung hinzu, um anzugeben, dass Sie einen Stundenzyklus hinzufügen. Fügen Sie schließlich den Stundenzyklustyp hinzu.

js
const locale = new Intl.Locale("fr-FR-u-hc-h23");
console.log(locale.hourCycle); // "h23"

Hinzufügen eines Stundenzyklus über das Konfigurationsobjekt-Argument

Der Intl.Locale() Konstruktor verfügt über ein optionales Konfigurationsobjekt-Argument, das eine von mehreren Erweiterungstypen enthalten kann, einschließlich Stundenzyklustypen. Setzen Sie die hourCycle Eigenschaft des Konfigurationsobjekts auf Ihren gewünschten Stundenzyklustyp, und übergeben Sie es dann an den Konstruktor.

js
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.Locale.prototype.hourCycle

Browser-Kompatibilität

Siehe auch