Intl.Locale.prototype.language

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 language Zugriffs-Eigenschaft von Instanzen des Objekts Intl.Locale gibt die mit diesem Gebietsschema verbundene Sprache zurück.

Beschreibung

Sprache ist eines der Kernattribute eines Gebietsschemas. Die Unicode-Spezifikation behandelt die Sprachkennung eines Gebietsschemas als Kombination aus Sprache und Region (um zwischen Dialekten und Variationen zu unterscheiden, z. B. Britisches Englisch vs. Amerikanisches Englisch). Die language-Eigenschaft eines Intl.Locale gibt strikt den Sprach-Subtag des Gebietsschemas zurück. Der Wert der language-Eigenschaft wird zum Zeitpunkt der Erstellung festgelegt, entweder durch den Sprach-Subtag (erster Teil) des Gebietsschema-Identifikators oder durch die language-Option des Intl.Locale() Konstruktors. Letztere hat Vorrang, wenn beide vorhanden sind.

Der Set-Accessor 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 Sprach-Subtag beginnen. Das Hauptargument des Intl.Locale() Konstruktors muss ein gültiger Unicode-Gebietsschema-Identifikator sein, daher muss immer, wenn der Konstruktor verwendet wird, ein Identifikator mit einem Sprach-Subtag übergeben werden.

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

Überschreiben der Sprache durch das Konfigurationsobjekt-Argument

Während der Sprach-Subtag spezifiziert werden muss, hat der Intl.Locale() Konstruktor ein optionales Konfigurationsobjekt-Argument, das den Sprach-Subtag überschreiben kann.

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

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.Locale.prototype.language

Browser-Kompatibilität

Siehe auch