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 mancher Browser wurde diese Methode als Accessor-Eigenschaft namens hourCycles implementiert. Da sie bei jedem Zugriff ein neues Array zurückgibt, ist sie inzwischen 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 für die Locale gebräuchlichen Stundenzyklustypen enthält, sortiert nach absteigender Präferenz. Wenn die Locale bereits einen hourCycle hat, enthält das zurückgegebene Array nur diesen Wert.
Im Folgenden sind die unterstützten Stundenzyklustypen aufgeführt.
Unterstützte Stundenzyklustypen
h12-
Stundensystem mit den Werten 1–12; entspricht „h“ in Formatmustern. Eine 12-Stunden-Uhr, bei der Mitternacht um 12:00 Uhr am beginnt. Wird beispielsweise in den Vereinigten Staaten verwendet.
h23-
Stundensystem mit den Werten 0–23; entspricht „H“ in Formatmustern. Eine 24-Stunden-Uhr, bei der Mitternacht um 0:00 Uhr beginnt.
h11-
Stundensystem mit den Werten 0–11; entspricht „K“ in Formatmustern. Eine 12-Stunden-Uhr, bei der Mitternacht um 0:00 Uhr am beginnt. Wird hauptsächlich in Japan verwendet.
h24-
Stundensystem mit den Werten 1–24; entspricht „k“ in Formatmustern. Eine 24-Stunden-Uhr, bei der Mitternacht um 24:00 Uhr beginnt. Wird nirgendwo verwendet.
Beispiele
Unterstützte Stundenzyklen abrufen
Wenn für das Locale-Objekt noch kein hourCycle festgelegt wurde, gibt getHourCycles() alle für die angegebene Locale gebräuchlichen Stundenzykluskennungen zurück. Beispiele für das explizite Festlegen eines hourCycle finden Sie unter Beispiele 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"]
Spezifikationen
| Spezifikation |
|---|
| Intl Locale Info Proposal # sec-Intl.Locale.prototype.getHourCycles |
Browser-Kompatibilität
Siehe auch
Intl.LocaleIntl.Locale.prototype.hourCycle- Unicode-Stundenzykluskennung in der Spezifikation der Unicode Locale Data Markup Language