Intl.Locale.prototype.region
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.
Die region-Accessor-Property von Intl.Locale-Instanzen gibt die Weltregion (in der Regel ein Land) zurück, die dieser Locale zugeordnet ist.
Beschreibung
Die Region ist eines der Kernattribute einer Locale. Sie ermöglicht es, Unterschiede zwischen Varianten derselben Sprache zu berücksichtigen, die beispielsweise in verschiedenen Ländern verwendet werden. Englisch wird etwa im Vereinigten Königreich und in den Vereinigten Staaten von Amerika gesprochen, doch Rechtschreibung und andere sprachliche Konventionen unterscheiden sich zwischen diesen beiden Ländern. Die Kenntnis der Region einer Locale hilft JavaScript-Entwicklern sicherzustellen, dass Inhalte ihrer Websites und Anwendungen korrekt dargestellt werden, wenn sie aus verschiedenen Teilen der Welt aufgerufen werden.
Der Wert der region-Property wird bei der Erstellung festgelegt: entweder durch den Teil des Locale-Bezeichners nach script oder durch die Option region des Konstruktors Intl.Locale(). Wenn beide angegeben sind, hat die Option Vorrang. Ist keiner von beiden angegeben, hat die Property den Wert undefined.
Der Set-Accessor von region ist undefined. Sie können diese Property nicht direkt ändern.
Beispiele
Wie andere Locale-Subtags kann die Region dem Intl.Locale-Objekt über den Locale-String oder über ein Konfigurationsobjekt als Argument für den Konstruktor hinzugefügt werden.
Eine Region über den Locale-String hinzufügen
Falls vorhanden, ist die Region der dritte Teil eines gültigen Unicode-Sprachbezeichners (oder der zweite Teil, wenn script nicht vorhanden ist). Sie kann dem ursprünglichen Locale-Bezeichner hinzugefügt werden, der an den Konstruktor Intl.Locale() übergeben wird. Beachten Sie, dass die Region kein erforderlicher Bestandteil eines Locale-Bezeichners ist.
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.region); // "US"
Eine Region über das Konfigurationsobjekt hinzufügen
Der Konstruktor Intl.Locale() akzeptiert optional ein Konfigurationsobjekt als Argument. Setzen Sie dessen region-Property auf die gewünschte Region und übergeben Sie das Objekt anschließend an den Konstruktor.
const locale = new Intl.Locale("fr-Latn", { region: "FR" });
console.log(locale.region); // "FR"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.Locale.prototype.region> |