Intl.Locale.prototype.hourCycle
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.
Die Accessor-Eigenschaft hourCycle von Intl.Locale-Instanzen gibt den Stundenzählungstyp für dieses Gebietsschema zurück.
Beschreibung
Weltweit werden hauptsächlich zwei Arten der Zeitanzeige verwendet: das 12-Stunden-Format und das 24-Stunden-Format. Eine Liste der unterstützten Stundenzählungstypen finden Sie unter Intl.Locale.prototype.getHourCycles().
Der Wert der Eigenschaft hourCycle wird beim Erstellen der Instanz festgelegt: entweder durch den Schlüssel hc im Gebietsschemabezeichner oder durch die Option hourCycle des Konstruktors Intl.Locale(). Sind beide vorhanden, hat die Option Vorrang. Ist keiner von beiden vorhanden, hat die Eigenschaft den Wert undefined.
Der Setter-Accessor von hourCycle ist undefined. Sie können diese Eigenschaft nicht direkt ändern.
Beispiele
Wie andere Teilkennungen eines Gebietsschemas kann der Stundenzählungstyp dem Intl.Locale-Objekt über die Gebietsschema-Zeichenfolge oder über ein Konfigurationsobjekt als Argument des Konstruktors hinzugefügt werden.
Stundenzählungstyp über die Gebietsschema-Zeichenfolge hinzufügen
Gemäß der Spezifikation für Unicode-Gebietsschema-Zeichenfolgen ist hourCycle eine „Erweiterungs-Teilkennung“. Solche Teilkennungen enthalten zusätzliche Informationen zum Gebietsschema und werden Gebietsschemabezeichnern mithilfe des Erweiterungsschlüssels -u hinzugefügt. Um der anfänglichen Gebietsschema-Zeichenfolge, die an den Konstruktor Intl.Locale() übergeben wird, einen Stundenzählungstyp hinzuzufügen, fügen Sie zunächst den Erweiterungsschlüssel -u hinzu, falls er noch nicht vorhanden ist. Fügen Sie anschließend die Erweiterung -hc hinzu, um anzugeben, dass Sie einen Stundenzählungstyp hinzufügen. Geben Sie zuletzt den Stundenzählungstyp an.
const locale = new Intl.Locale("fr-FR-u-hc-h23");
console.log(locale.hourCycle); // "h23"
Stundenzählungstyp über ein Konfigurationsobjekt hinzufügen
Der Konstruktor Intl.Locale() akzeptiert ein optionales Konfigurationsobjekt als Argument. Dieses kann verschiedene Erweiterungstypen enthalten, darunter Stundenzählungstypen. Setzen Sie die Eigenschaft hourCycle des Konfigurationsobjekts auf den gewünschten Stundenzählungstyp und übergeben Sie das Objekt anschließend an den Konstruktor.
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.Locale.prototype.hourCycle> |
Browser-Kompatibilität
Siehe auch
Intl.LocaleIntl.Locale.prototype.getHourCycles()- Unicode Hour Cycle Identifier in der Spezifikation der Unicode Locale Data Markup Language