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.
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.
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
Intl.Locale
Intl.Locale.prototype.getHourCycles()
- Unicode Hour Cycle Identifier in der Unicode Locale-Daten-Markup-Sprachspezifikation