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.
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.
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-Lokalisierungsdaten-Auszeichnungssprachen-Spezifikation