Intl.Locale.prototype.language

Beschreibung

Die Sprache ist eines der Kerneigenschaften eines Gebietsschemas. Die Unicode-Spezifikation behandelt den Sprachidentifikator eines Gebietsschemas als Sprache und Region zusammen (um eine Unterscheidung zwischen Dialekten und Varianten zu treffen, z.B. Britisches Englisch vs. Amerikanisches Englisch). Die language Eigenschaft eines Intl.Locale gibt strikt den Sprachuntertag des Gebietsschemas zurück.

Der Wert der language Eigenschaft wird zur Erstellungszeit festgelegt, entweder durch den ersten Teil des Gebietsschema-Identifikators oder durch die language Option des Intl.Locale() Konstruktors. Letztere hat Vorrang, wenn beide vorhanden sind.

Der Set-Zugriffsgeber von language ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Gebietsschema-Subtags kann die Sprache dem Intl.Locale Objekt über den Gebietsschema-String oder ein Konfigurationsobjekt-Argument des Konstruktors hinzugefügt werden.

Festlegen der Sprache über den Gebietsschema-String

Um ein gültiger Unicode-Gebietsschema-Identifikator zu sein, muss ein String mit dem Sprachuntertag beginnen. Das Hauptargument des Intl.Locale() Konstruktors muss ein gültiger Unicode-Gebietsschema-Identifikator sein, daher muss bei der Verwendung des Konstruktors ein Identifikator mit einem Sprachuntertag übergeben werden.

const locale = new Intl.Locale("en-Latn-US");
console.log(locale.language); // "en"

Überschreiben der Sprache über das Konfigurationsobjekt-Argument

Obwohl der Sprachuntertag angegeben werden muss, verfügt der Intl.Locale() Konstruktor über ein optionales Konfigurationsobjekt-Argument, das den Sprachuntertag überschreiben kann.

const locale = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(locale.language); // "es"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Intl.Locale
• Unicode language subtag in der Spezifikation zur Unicode-Gebietsschemadaten-Markup-Sprache