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 Accessor-Eigenschaft von Intl.Locale-Instanzen gibt den Stundenzyklustyp für diese Lokalisierung zurück.

Beschreibung

Es gibt zwei Haupttypen von Zeitmessungskonventionen (Uhren), die weltweit verwendet werden: die 12-Stunden-Uhr und die 24-Stunden-Uhr. Der Wert der hourCycle-Eigenschaft wird zum Zeitpunkt der Erstellung festgelegt, entweder über den hc-Schlüssel des Lokalisierungsbezeichners oder über die hourCycle-Option des Intl.Locale()-Konstruktors. Letzteres hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

Für eine Liste der unterstützten Stundenzyklustypen siehe Intl.Locale.prototype.getHourCycles().

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 zum Konstruktor hinzugefügt werden.

Hinzufügen eines Stundenzyklus über den Locale-String

In der Unicode Locale String Spezifikation sind Stundenzyklustypen Locale-Key-"Extension-Subtags". Diese Subtags fügen zusätzliche Daten über die Lokalisierung hinzu und werden durch die Verwendung der -u-Erweiterung den Locale-Bezeichnern hinzugefügt. Somit kann der Stundenzyklustyp dem anfänglichen Locale-Bezeichner-String hinzugefügt werden, der in den Intl.Locale()-Konstruktor übergeben wird. Um den Stundenzyklustyp hinzuzufügen, fügen Sie zuerst den -u-Erweiterungsschlüssel zum String hinzu. Fügen Sie als nächstes die -hc-Erweiterung hinzu, um anzugeben, dass Sie einen Stundenzyklus hinzufügen. Schließlich fügen Sie den Stundenzyklustyp zum String 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 hat ein optionales Konfigurationsobjekt-Argument, das mehrere Erweiterungstypen enthalten kann, einschließlich Stundenzyklustypen. Legen Sie die hourCycle-Eigenschaft des Konfigurationsobjekts auf Ihren gewünschten Stundenzyklustyp fest 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