Intl.Locale.prototype.variants

Die variants Zugriffseigenschaft von Intl.Locale-Instanzen gibt die Varianten zurück, die dieser Locale zugeordnet sind, als eine durch Bindestriche (-) getrennte Zeichenkette von Identifikatoren in der ursprünglich angegebenen Reihenfolge.

Beschreibung

Varianten sind Teil der Hauptsprachen-ID. Sie wählen Varianten einer Sprache aus, die das (Sprache, Region, Skript)-Triplett nicht unterscheiden kann. Normalerweise repräsentieren sie dieselbe Sprache in unterschiedlichen Epochen oder verschiedenen Orthografien. Zum Beispiel hat Deutsch die Orthografievarianten 1901 und 1996, die als de-1901 und de-1996 geschrieben werden; die Variante "Frühmoderne Englisch (1500-1700)" wird als en-emodeng geschrieben. Das Subtag kann mehrere durch Bindestriche (-) getrennte Identifikatoren enthalten. Diese Identifikatoren sind technisch gesehen ungeordnet, obwohl sie in der Praxis oft eine semantische Hierarchie haben — zum Beispiel wird der Resian-Dialekt des Slowenischen als sl-rozaj geschrieben, und der San Giorgio/Bila-Dialekt von Resian wird als sl-rozaj-biske geschrieben.

Der Wert der variants-Eigenschaft wird bei der Konstruktion festgelegt, entweder durch den Teil des Locale-Identifikators nach der region oder durch die variants-Option des Intl.Locale()-Konstruktors. Letztere hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

Der Set-Accessor von variants ist undefined. Man kann diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Locale-Subtags können die Varianten über den locale-String oder ein Konfigurationsobjekt-Argument in das Intl.Locale-Objekt hinzugefügt werden.

Hinzufügen von Varianten über den locale-String

Die Varianten, wenn vorhanden, sind die letzten Teile eines gültigen Unicode-Sprachidentifikator-Strings und können dem initialen Locale-Identifikator-String hinzugefügt werden, der in den Intl.Locale()-Konstruktor übergeben wird. Beachten Sie, dass die Varianten kein erforderlicher Teil eines Locale-Identifikators sind.

js
const locale = new Intl.Locale("sl-rozaj-biske");
console.log(locale.variants); // "rozaj-biske"

Hinzufügen von Varianten über das Konfigurationsobjekt

Der Intl.Locale()-Konstruktor hat ein optionales Konfigurationsobjekt-Argument. Setzen Sie die variants-Eigenschaft des Konfigurationsobjekts auf die gewünschten Varianten und übergeben Sie sie dann an den Konstruktor.

js
const locale = new Intl.Locale("sl", { variants: "rozaj-biske" });
console.log(locale.variants); // "rozaj-biske"

Spezifikationen

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

Browser-Kompatibilität

Siehe auch