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
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.
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getHourCycles()); // ["h12"]
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.
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
Intl.LocaleIntl.Locale.prototype.hourCycle- Unicode-Kennung für Stundenzyklen in der Spezifikation der Unicode Locale Data Markup Language