Intl.Locale.prototype.region
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 region Zugriffsproperty von Intl.Locale Instanzen gibt die mit dieser Locale verbundene Region der Welt (gewöhnlich ein Land) zurück.
Beschreibung
Die Region ist eines der Kernelemente einer Locale. Sie ermöglicht die Auswahl für Unterschiede zwischen der gleichen Sprache in verschiedenen Ländern. Zum Beispiel wird Englisch sowohl im Vereinigten Königreich als auch in den Vereinigten Staaten von Amerika gesprochen, aber es gibt Unterschiede in der Rechtschreibung und anderen Sprachkonventionen zwischen diesen beiden Ländern. Das Wissen über die Region einer Locale hilft JavaScript-Programmierern sicherzustellen, dass der Inhalt ihrer Websites und Anwendungen korrekt dargestellt wird, wenn er aus verschiedenen Teilen der Welt betrachtet wird. Der Wert der region Property wird zur Konstruktionszeit festgelegt, entweder durch den region Untertag (dritter Teil, wenn script vorhanden ist, ansonsten zweiter Teil) der Locale-Kennung oder durch die region Option des Intl.Locale() Konstruktors. Letzteres hat Vorrang, wenn beide vorhanden sind; und wenn keiner von beiden vorhanden ist, hat die Property den Wert undefined.
Der set-Zugriff von region ist undefined. Sie können diese Property nicht direkt ändern.
Beispiele
Wie andere Locale-Untertags kann die Region über den Locale-String oder ein Konfigurationsobjekt-Argument zum Konstruktor dem Intl.Locale Objekt hinzugefügt werden.
Hinzufügen einer Region über den Locale-String
Die Region, falls vorhanden, ist der dritte Teil (wenn script vorhanden ist, ansonsten der zweite Teil) eines gültigen Unicode-Sprachbezeichner-Strings und kann dem initialen Locale-Bezeichner-String hinzugefügt werden, der in den Intl.Locale() Konstruktor übergeben wird. Beachten Sie, dass die Region kein erforderlicher Teil eines Locale-Bezeichners ist.
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.region); // Prints "US"
Hinzufügen einer Region über das Konfigurationsobjekt-Argument
Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument. Setzen Sie die region Property des Konfigurationsobjekts auf Ihre gewünschte Region und übergeben Sie diese dann an den Konstruktor.
const locale = new Intl.Locale("fr-Latn", { region: "FR" });
console.log(locale.region); // Prints "FR"
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-Intl.Locale.prototype.region |