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.
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.
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
Intl.Locale
- Unicode-Sprachsubtag in der Unicode-Gebietsschema-Daten-Markupsprache-Spezifikation