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
-Zugriffseigenschaft von Intl.Locale
-Instanzen gibt die Sprache zurück, die mit dieser Lokalisierung verbunden ist.
Beschreibung
Die Sprache ist eines der Kerneigenschaften einer Lokalisierung. Die Unicode-Spezifikation behandelt den Sprachbezeichner einer Lokalisierung als Kombination aus Sprache und Region (um Unterschiede zwischen Dialekten und Varianten zu kennzeichnen, z. B. Britisches Englisch vs. Amerikanisches Englisch). Die language
-Eigenschaft eines Intl.Locale
gibt streng genommen nur das Sprachsubtag der Lokalisierung zurück. Der Wert der language
-Eigenschaft wird zur Zeitpunkt der Erstellung festgelegt, entweder durch das language
-Subtag (erster Teil) der Lokalisierungskennung oder durch die language
-Option des Intl.Locale()
-Konstruktors. Letztere hat Priorität, wenn beide vorhanden sind.
Der Set-Accessor von language
ist undefined
. Sie können diese Eigenschaft nicht direkt ändern.
Beispiele
Wie andere Lokalisierungs-Subtags kann die Sprache dem Intl.Locale
-Objekt über den Lokalisierungs-String oder ein Konfigurationsobjekt-Argument für den Konstruktor hinzugefügt werden.
Festlegen der Sprache über den Lokalisierungs-String
Um ein gültiger Unicode-Lokalisierungsbezeichner zu sein, muss ein String mit dem Sprachsubtag beginnen. Das Hauptargument für den Intl.Locale()
-Konstruktor muss ein gültiger Unicode-Lokalisierungsbezeichner sein, sodass beim Gebrauch des Konstruktors ein Bezeichner mit einem Sprachsubtag übergeben werden muss.
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.language); // Prints "en"
Überschreiben der Sprache via Konfigurationsobjekt-Argument
Während das Sprachsubtag spezifiziert werden muss, hat der Intl.Locale()
-Konstruktor ein optionales Konfigurationsobjekt-Argument, das das Sprachsubtag überschreiben kann.
const locale = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(locale.language); // Prints "es"
Spezifikationen
Specification |
---|
ECMAScript Internationalization API Specification # sec-Intl.Locale.prototype.language |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
Intl.Locale
- Unicode Sprachsubtag in der Unicode-Lokalisierungsdaten-Markupsprache-Spezifikation