Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

js
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.

js
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