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

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. Der Intl-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" (gbsct bezeichnet 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 rg nicht 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, etwa en-US für die USA oder zh-CN fü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 das rg-Erweiterungs-Subtag. Gemäß Unicode sollte es sich um eine Unterteilungs-ID handeln, die mit dem Regions-Subtag übereinstimmt, falls eines vorhanden ist. Für Intl ist sd jedoch 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 (en wird üblicherweise wie en-US behandelt). 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:

js
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 Locale als Teilzeichenfolge der vollständigen Datenzeichenfolge zurück.

Intl.Locale.prototype.calendar

Gibt den Teil der Locale zurü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 Locale zurü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 Konstruktor Intl.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 in Object.prototype.toString() verwendet.

Instanzmethoden

Intl.Locale.prototype.getCalendars()

Gibt ein Array verfügbarer Kalenderbezeichner gemäß den Regeln der Locale zurück.

Intl.Locale.prototype.getCollations()

Gibt ein Array der Sortiertypen für die Locale zurück.

Intl.Locale.prototype.getHourCycles()

Gibt ein Array von 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 Array der 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) oder rtl (von rechts nach links).

Intl.Locale.prototype.getTimeZones()

Gibt ein Array von Zeitzonen-Bezeichnern zurück, die mit der Locale verknü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:

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

js
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