DasIntl.Locale-Objekt ist eine standardmäßig integrierte Eigenschaft des Intl-Objekts, das einen Unicode-Locale-Identifikator darstellt.

Probieren Sie es aus

const korean = new Intl.Locale("ko", {  script: "Kore",  region: "KR",  hourCycle: "h23",  calendar: "gregory",});const japanese = new Intl.Locale("ja-Jpan-JP-u-ca-japanese-hc-h12");console.log(korean.baseName, japanese.baseName);// Expected output: "ko-Kore-KR" "ja-Jpan-JP"console.log(korean.hourCycle, japanese.hourCycle);// Expected output: "h23" "h12"

Beschreibung

DasIntl.Locale-Objekt wurde erstellt, um die Manipulation von Unicode-Locale zu erleichtern. Unicode repräsentiert Locales mit einem String, der einLocale-Identifikator genannt wird. Der Locale-Identifikator besteht aus einemSprachidentifikator undErweiterungstags. Sprachidentifikatoren sind der Kern der Locale und bestehen ausSprache,Schrift,Region undVarianten Subtags. Zusätzliche Informationen über die Locale werden in den optionalenErweiterungstags gespeichert. Erweiterungstags enthalten Informationen über Aspekte der Locale wie Kalenderart, Uhrzeitsystem und Nummerierungssystem.

Traditionell hat die Intl-API Strings verwendet, um Locales darzustellen, genau wie Unicode. Dies ist eine einfache und leichte Lösung, die gut funktioniert. Das Hinzufügen einer Locale-Klasse erleichtert jedoch das Parsen und Manipulieren von Sprache, Schrift und Region sowie Erweiterungstags. Die folgenden Eigenschaften vonIntl.Locale entsprechen Unicode-Locale-Identifikator-Subtags:

Die obigen Informationen werden genau so bereitgestellt, wie sie sind, wenn dasLocale-Objekt erstellt wird, ohne eine externe Datenbank zu konsultieren. DasIntl.Locale-Objekt bietet zusätzlich einige Methoden, die Informationen über die realen Informationen der Locale zurückgeben, wie verfügbare Kalender, Kollationen und Nummerierungssysteme.

Konstruktor

Intl.Locale()

Erstellt ein neuesLocale-Objekt.

Instanz-Eigenschaften

Diese Eigenschaften sind aufIntl.Locale.prototype definiert und werden von allenIntl.Locale-Instanzen geteilt.

Intl.Locale.prototype.baseName

Gibt grundlegende, zentrale Informationen über dasLocale in Form eines Substrings der vollständigen Datenzeichenkette zurück.

Intl.Locale.prototype.calendar

Gibt den Teil desLocale zurück, der die Kalenderära der Locale angibt.

Intl.Locale.prototype.caseFirst

Gibt zurück, ob bei der Kollation der Locale die Groß- und Kleinschreibung berücksichtigt wird.

Intl.Locale.prototype.collation

Gibt den Kollationstyp für dasLocale zurück, der verwendet wird, um Zeichenfolgen entsprechend den Regeln der Locale zu ordnen.

Intl.Locale.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. BeiIntl.Locale-Instanzen ist der Ausgangswert derIntl.Locale-Konstruktor.

Intl.Locale.prototype.hourCycle

Gibt das Zeitformatkonvention zurück, das von der Locale verwendet wird.

Intl.Locale.prototype.language

Gibt die Sprache zurück, die mit der Locale verbunden ist.

Intl.Locale.prototype.numberingSystem

Gibt das Ziffernsystem zurück, das von der Locale verwendet wird.

Intl.Locale.prototype.numeric

Gibt zurück, ob die Locale spezielle Kollationsverarbeitung für numerische Zeichen hat.

Intl.Locale.prototype.region

Gibt die Region der Welt (meist ein Land) zurück, die mit der Locale verbunden ist.

Intl.Locale.prototype.script

Gibt das Skript zurück, das für das Schreiben der bestimmten Sprache verwendet wird, die in der Locale verwendet wird.

Intl.Locale.prototype.variants

Gibt die Varianten-Subtags (wie verschiedene Orthografien) zurück, die mit der Locale verbunden sind.

Intl.Locale.prototype[Symbol.toStringTag]

Der Ausgangswert der[Symbol.toStringTag]-Eigenschaft ist die Zeichenfolge"Intl.Locale". Diese Eigenschaft wird inObject.prototype.toString() verwendet.

Instanz-Methoden

Intl.Locale.prototype.getCalendars()

Gibt einArray von verfügbaren Kalender-Identifikatoren entsprechend den Regeln der Locale zurück.

Intl.Locale.prototype.getCollations()

Gibt einArray der Kollationstypen für dasLocale zurück.

Intl.Locale.prototype.getHourCycles()

Gibt einArray von Stundensystem-Identifikatoren zurück und zeigt entweder die 12-Stunden-Uhr ("h12"), die japanische 12-Stunden-Uhr ("h11"), die 24-Stunden-Uhr ("h23") oder das unbenutzte Format "h24" an.

Intl.Locale.prototype.getNumberingSystems()

Gibt einArray von Nummerierungssystem-Identifikatoren zurück, die entsprechend den Regeln der Locale verfügbar sind.

Intl.Locale.prototype.getTextInfo()

Gibt den Teil zurück, der die Anordnung der Zeichenltr (von links nach rechts) oderrtl (von rechts nach links) angibt.

Intl.Locale.prototype.getTimeZones()

Gibt einArray von Zeitzonen-Identifikatoren zurück, die mit derLocale verbunden sind.

Intl.Locale.prototype.getWeekInfo()

Gibt dieWochenelemente von UTS 35 entsprechend den Locale-Regeln zurück.

Intl.Locale.prototype.maximize()

Ruft die wahrscheinlichsten Werte für Sprache, Skript und Region der Locale basierend auf bestehenden Werten ab.

Intl.Locale.prototype.minimize()

Versucht, Informationen über die Locale zu entfernen, die durch den Aufruf vonmaximize() hinzugefügt würde.

Intl.Locale.prototype.toString()

Gibt die vollständige Locale-Identifikator-Zeichenkette der Locale zurück.

Beispiele

Grundlegende Nutzung

Im einfachsten Fall nimmt derIntl.Locale()-Konstruktor eine Locale-Identifikator-Zeichenkette als Argument:

const us = new Intl.Locale("en-US");

Verwenden des Locale-Konstruktors mit einem Optionsobjekt

Der Konstruktor nimmt auch ein optionales Konfigurationsobjektargument, das eine beliebige Anzahl von Erweiterungstypen enthalten kann. Zum Beispiel setzen Sie diehourCycle-Eigenschaft des Konfigurationsobjekts auf Ihren gewünschten Stundensystem-Typ und übergeben es dann an den Konstruktor:

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonIntl.Locale in FormatJS
• Intl
• Kanonische Unicode-Locale-Identifikatoren in der Unicode Locale Data Markup Language Spezifikation