Intl.Locale
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.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das Intl.Locale-Objekt ist eine standardmäßige integrierte Eigenschaft des Intl-Objekts, die einen Unicode-Locale-Bezeichner 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
Das Intl.Locale-Objekt wurde geschaffen, um die Arbeit mit Unicode-Locales zu erleichtern. Unicode stellt Locales durch Zeichenfolgen dar, die als Locale-Bezeichner bezeichnet werden. Ein Locale-Bezeichner besteht aus einem Sprachbezeichner und Erweiterungs-Subtags. Der Sprachbezeichner bildet den Kern der Locale und setzt sich aus Subtags für Sprache, Schrift, Region und Varianten zusammen. Zusätzliche Informationen über die Locale werden in den optionalen Erweiterungs-Subtags gespeichert. Diese enthalten Informationen zu Aspekten der Locale wie Kalendertyp, Uhrzeitformat und Zahlensystem.
Traditionell verwendet die Intl-API wie Unicode Zeichenfolgen, um Locales darzustellen. Das ist eine einfache und ressourcenschonende Lösung, die gut funktioniert. Eine Locale-Klasse erleichtert jedoch das Analysieren und Bearbeiten von Sprache, Schrift, Region und Erweiterungs-Subtags. Die folgenden Eigenschaften von Intl.Locale entsprechen Subtags eines Unicode-Locale-Bezeichners:
| Eigenschaft | Entsprechendes Subtag |
|---|---|
language |
Sprachbezeichner, erster Teil |
script |
Sprachbezeichner, Teil nach language |
region |
Sprachbezeichner, Teil nach script |
variants |
Sprachbezeichner, Teil nach region |
calendar |
ca (Erweiterung) |
caseFirst |
kf (Erweiterung) |
collation |
co (Erweiterung) |
firstDayOfWeek |
fw (Erweiterung) |
hourCycle |
hc (Erweiterung) |
numberingSystem |
nu (Erweiterung) |
numeric |
kn (Erweiterung) |
Die oben genannten Informationen werden beim Erstellen des Locale-Objekts unverändert übernommen, ohne eine externe Datenbank abzufragen. Darüber hinaus bietet das Intl.Locale-Objekt Methoden, die Informationen über die tatsächlichen Gegebenheiten einer Locale zurückgeben, etwa verfügbare Kalender, Sortierreihenfolgen und Zahlensysteme.
Regionale Präferenzen
Die Methoden getCalendars(), getHourCycles() und getWeekInfo() geben Datums- und Zeitkonventionen zurück. Diese hängen von der Region der Locale ab, manchmal auch von der Sprache: Beispielsweise können für englischsprachiges Kanada (en-CA) und französischsprachiges Kanada (fr-CA) unterschiedliche Konventionen gelten. Die Region wird wie folgt bestimmt:
- Falls ein gültiges
rg-Erweiterungs-Subtag vorhanden ist, wird dieses zuerst berücksichtigt. Sein Wert besteht aus einem Regionscode, gefolgt von 1 bis 4 alphanumerischen Zeichen. DerIntl-Parser berücksichtigt diese angehängten Zeichen nicht. Gemäß Unicode sollten sie jedoch"zzzz"lauten, um eine gesamte Region zu bezeichnen, oder eine Unterteilungs-ID sein. Beispielsweise bewirken die Tags"en-US-u-rg-gbzzzz"und"en-US-u-rg-gbsct"(gbsctbezeichnet die Unterteilung Schottland), dass die meisten Lokalisierungsmethoden amerikanisches Englisch und US-amerikanische Konventionen auswählen. Die drei Methoden für Datums- und Zeitkonventionen verwenden stattdessen jedoch die Konventionen des Vereinigten Königreichs. - Wenn
rgnicht vorhanden oder ungültig ist oder für die angegebene Region keine Konventionsdaten vorliegen, wird das Regions-Subtag verwendet, sofern es vorhanden ist. Dies dürfte der häufigste Fall sein, etwaen-USfür die USA oderzh-CNfür China. - Wenn kein Regions-Subtag vorhanden ist, wird das
sd-Erweiterungs-Subtag verwendet, sofern es vorhanden und gültig ist. Es folgt derselben Grammatik wie dasrg-Erweiterungs-Subtag. Gemäß Unicode sollte es sich um eine Unterteilungs-ID handeln, die mit dem Regions-Subtag übereinstimmt, falls eines vorhanden ist. FürIntlistsdjedoch im Allgemeinen nicht erforderlich, wenn bereits eine Region angegeben ist, da diese ohnehin Vorrang hat. Beispielsweise bewirkt das Tag"en-u-sd-gbsct", dass die meisten Lokalisierungsmethoden amerikanisches Englisch und US-amerikanische Konventionen auswählen (enwird üblicherweise wieen-USbehandelt). Die drei Methoden für Datums- und Zeitkonventionen verwenden stattdessen jedoch die Konventionen des Vereinigten Königreichs. - Wenn die
sd-Erweiterung nicht vorhanden oder ungültig ist, wird die wahrscheinlichste Region der Locale verwendet. Falls auch diese nicht bestimmt werden kann, wird auf die Weltregion ("001") zurückgegriffen.
Vergleichen Sie die folgenden Beispiele:
new Intl.Locale("en").getHourCycles(); // ["h12"]; US convention
new Intl.Locale("en-GB").getHourCycles(); // ["h23"]; UK convention
new Intl.Locale("en-u-rg-gbzzzz").getHourCycles(); // ["h23"]
new Intl.Locale("en-u-sd-gbsct").getHourCycles(); // ["h23"]
new Intl.Locale("en-US-u-rg-gbzzzz").getHourCycles(); // ["h23"]
new Intl.Locale("en-US-u-sd-gbsct").getHourCycles(); // ["h12"]
Weder rg noch sd werden über eine Eigenschaft von Intl.Locale bereitgestellt oder können über eine Konstruktoroption angepasst werden. Die von diesen Methoden zurückgegebenen Werte können auch durch andere Erweiterungs-Subtags beeinflusst werden, wie auf den jeweiligen Seiten dokumentiert.
Konstruktor
Intl.Locale()-
Erstellt ein neues
Locale-Objekt.
Instanzeigenschaften
Diese Eigenschaften sind auf Intl.Locale.prototype definiert und werden von allen Intl.Locale-Instanzen gemeinsam genutzt.
Intl.Locale.prototype.baseName-
Gibt grundlegende Informationen über die
Localeals Teilzeichenfolge der vollständigen Datenzeichenfolge zurück. Intl.Locale.prototype.calendar-
Gibt den Teil der
Localezurück, der ihren Kalendertyp angibt. Intl.Locale.prototype.caseFirst-
Gibt an, ob nach den Sortierregeln der Locale Groß- oder Kleinbuchstaben zuerst eingeordnet werden.
Intl.Locale.prototype.collation-
Gibt den Sortiertyp für die
Localezurück, der verwendet wird, um Zeichenfolgen nach den Regeln der Locale zu ordnen. Intl.Locale.prototype.constructor-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Intl.Locale-Instanzen ist der Anfangswert der KonstruktorIntl.Locale. Intl.Locale.prototype.firstDayOfWeek-
Gibt den für die Locale festgelegten ersten Tag der Woche zurück.
Intl.Locale.prototype.hourCycle-
Gibt das in der Locale verwendete Uhrzeitformat zurück.
Intl.Locale.prototype.language-
Gibt die mit der Locale verknüpfte Sprache zurück.
Intl.Locale.prototype.numberingSystem-
Gibt das von der Locale verwendete Zahlensystem zurück.
Intl.Locale.prototype.numeric-
Gibt an, ob die Locale spezielle Sortierregeln für numerische Zeichen verwendet.
Intl.Locale.prototype.region-
Gibt die mit der Locale verknüpfte Weltregion zurück, üblicherweise ein Land.
Intl.Locale.prototype.script-
Gibt die Schrift zurück, mit der die Sprache der Locale geschrieben wird.
Intl.Locale.prototype.variants-
Gibt die mit der Locale verknüpften Varianten-Subtags zurück, beispielsweise für unterschiedliche Rechtschreibungen.
Intl.Locale.prototype[Symbol.toStringTag]-
Der Anfangswert der Eigenschaft
[Symbol.toStringTag]ist die Zeichenfolge"Intl.Locale". Diese Eigenschaft wird inObject.prototype.toString()verwendet.
Instanzmethoden
Intl.Locale.prototype.getCalendars()-
Gibt ein
Arrayverfügbarer Kalenderbezeichner gemäß den Regeln der Locale zurück. Intl.Locale.prototype.getCollations()-
Gibt ein
Arrayder Sortiertypen für dieLocalezurück. Intl.Locale.prototype.getHourCycles()-
Gibt ein
Arrayvon Uhrzeitformat-Bezeichnern zurück. Diese bezeichnen entweder das 12-Stunden-Format ("h12"), das japanische 12-Stunden-Format ("h11"), das 24-Stunden-Format ("h23") oder das nicht verwendete Format "h24". Intl.Locale.prototype.getNumberingSystems()-
Gibt ein
Arrayder nach den Regeln der Locale verfügbaren Zahlensystem-Bezeichner zurück. Intl.Locale.prototype.getTextInfo()-
Gibt den Teil zurück, der die Schreibrichtung der Zeichen angibt:
ltr(von links nach rechts) oderrtl(von rechts nach links). Intl.Locale.prototype.getTimeZones()-
Gibt ein
Arrayvon Zeitzonen-Bezeichnern zurück, die mit derLocaleverknüpft sind. Intl.Locale.prototype.getWeekInfo()-
Gibt die Wochenelemente aus UTS 35 gemäß den Regeln der Locale zurück.
Intl.Locale.prototype.maximize()-
Ermittelt anhand der vorhandenen Werte die wahrscheinlichsten Werte für Sprache, Schrift und Region der Locale.
Intl.Locale.prototype.minimize()-
Versucht, Informationen über die Locale zu entfernen, die durch einen Aufruf von
maximize()wieder hinzugefügt würden. Intl.Locale.prototype.toString()-
Gibt den vollständigen Locale-Bezeichner der Locale als Zeichenfolge zurück.
Beispiele
>Grundlegende Verwendung
Im einfachsten Fall erhält der Konstruktor Intl.Locale() eine Zeichenfolge mit einem Locale-Bezeichner als Argument:
const us = new Intl.Locale("en-US");
Verwendung des Locale-Konstruktors mit einem Optionsobjekt
Der Konstruktor akzeptiert außerdem ein optionales Konfigurationsobjekt als Argument, das verschiedene Erweiterungstypen enthalten kann. Setzen Sie beispielsweise die Eigenschaft hourCycle des Konfigurationsobjekts auf das gewünschte Uhrzeitformat und übergeben Sie das Objekt anschließend an den Konstruktor:
const us12hour = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(us12hour.hourCycle); // Prints "h12"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # locale-objects> |
Browser-Kompatibilität
Siehe auch
- Polyfill für
Intl.Localein FormatJS Intl- Kanonische Unicode-Locale-Bezeichner in der Spezifikation der Unicode Locale Data Markup Language