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