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 Zugriffsproperty von Intl.Locale Instanzen gibt den Stundentypen für diese Locale zurück.

Beschreibung

Weltweit werden zwei Hauptarten der Zeitmessung (Uhren) verwendet: die 12-Stunden-Uhr und die 24-Stunden-Uhr. Der Wert der hourCycle Eigenschaft wird zur Bauzeit festgelegt, entweder durch den hc Schlüssel des Locale-Bezeichners oder durch die hourCycle Option des Intl.Locale() Konstruktors. Letzterer hat Priorität, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

Eine Liste der unterstützten Stundentypen finden Sie unter 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 Stundentyp dem Intl.Locale Objekt über den Locale-String oder ein Konfigurationsobjekt-Argument zum Konstruktor hinzugefügt werden.

Hinzufügen eines Stundentypen über den Locale-String

In der Unicode-Locale-String-Spezifikation sind Stundentypen Locale-Schlüssel "Erweiterungs-Subtags". Diese Subtags fügen zusätzliche Daten über das Locale hinzu und werden zu Locale-Bezeichnern durch Verwendung der -u Erweiterung hinzugefügt. Somit kann der Stundentyp dem anfänglichen Locale-Bezeichner-String hinzugefügt werden, der in den Intl.Locale() Konstruktor übergeben wird. Um den Stundentyp hinzuzufügen, fügen Sie zuerst den -u Erweiterungsschlüssel dem String hinzu. Als Nächstes fügen Sie die -hc Erweiterung hinzu, um anzugeben, dass Sie einen Stundentyp hinzufügen. Schließlich fügen Sie den Stundentyp dem String hinzu.

js
const locale = new Intl.Locale("fr-FR-u-hc-h23");
console.log(locale.hourCycle); // "h23"

Hinzufügen eines Stundentypen über das Konfigurationsobjekt-Argument

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das eine Vielzahl von Erweiterungstypen enthalten kann, einschließlich Stundentypen. Setzen Sie die hourCycle Eigenschaft des Konfigurationsobjekts auf Ihren gewünschten Stundentyp und übergeben Sie es dann an den Konstruktor.

js
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"

Spezifikationen

Specification
ECMAScript Internationalization API Specification
# sec-Intl.Locale.prototype.hourCycle

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch