Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Intl.Locale.prototype.getHourCycles()

Baseline 2026
Neu verfügbar

Seit Juli 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die Methode getHourCycles() von Intl.Locale-Instanzen gibt eine Liste mit einem oder mehreren eindeutigen Kennungen für Stundenzyklen dieser Locale zurück.

Hinweis: In einigen Versionen bestimmter Browser wurde diese Methode als Accessor-Eigenschaft namens hourCycles implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, ist sie nun als Methode implementiert. So wird vermieden, dass locale.hourCycles === locale.hourCycles den Wert false zurückgibt. Einzelheiten finden Sie in der Tabelle zur Browser-Kompatibilität.

Syntax

js
getHourCycles()

Parameter

Keine.

Rückgabewert

Ein Array von Strings, das alle gemäß den Regionseinstellungen für die Locale gebräuchlichen Stundenzyklustypen enthält, sortiert nach absteigender Präferenz. Wenn für die Locale bereits ein Wert für hourCycle festgelegt ist, enthält das zurückgegebene Array nur diesen Wert.

Im Folgenden sind die unterstützten Stundenzyklustypen aufgeführt.

Unterstützte Stundenzyklustypen

h12

Stundensystem von 1 bis 12; entspricht „h“ in Mustern. Die 12-Stunden-Uhr, bei der Mitternacht um 12:00 am beginnt. Wird beispielsweise in den Vereinigten Staaten verwendet.

h23

Stundensystem von 0 bis 23; entspricht „H“ in Mustern. Die 24-Stunden-Uhr, bei der Mitternacht um 0:00 beginnt.

h11

Stundensystem von 0 bis 11; entspricht „K“ in Mustern. Die 12-Stunden-Uhr, bei der Mitternacht um 0:00 am beginnt. Wird hauptsächlich in Japan verwendet.

h24

Stundensystem von 1 bis 24; entspricht „k“ in Mustern. Die 24-Stunden-Uhr, bei der Mitternacht um 24:00 beginnt. Wird nirgendwo verwendet.

Beispiele

Unterstützte Stundenzyklen abrufen

Wenn für das Locale-Objekt noch kein hourCycle festgelegt ist, listet getHourCycles() alle gebräuchlichen Kennungen für Stundenzyklen der angegebenen Locale auf. Beispiele für das explizite Festlegen eines hourCycle finden Sie in den Beispielen zu hourCycle.

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getHourCycles()); // ["h12"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getHourCycles()); // ["h23"]

Regionsüberschreibungen

Die Erweiterungs-Subtags rg und sd ändern die Regionseinstellungen. Dadurch können andere Kennungen für Stundenzyklen zurückgegeben werden, während der Basisname gleich bleibt.

js
const enUS = new Intl.Locale("en-US");
console.log(enUS.getHourCycles()); // ["h12"]

const enUSInJP = new Intl.Locale("en-US-u-rg-jpzzzz");
console.log(enUSInJP.getHourCycles()); // ["h23"]

const enScot = new Intl.Locale("en-u-sd-gbsct");
console.log(enScot.getHourCycles()); // ["h23"]

Spezifikationen

Spezifikation
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getHourCycles

Browser-Kompatibilität

Siehe auch