Intl.RelativeTimeFormat.supportedLocalesOf()
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 statische Methode Intl.RelativeTimeFormat.supportedLocalesOf() gibt ein Array zurück, das die unterstützten der bereitgestellten Locales für die relative Zeitformatierung enthält, ohne dass auf die Standard-Locale der Laufzeitumgebung zurückgegriffen werden muss.
Probieren Sie es aus
const locales1 = ["ban", "id-u-co-pinyin", "de-ID"];
const options1 = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales1, options1));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)
Syntax
Intl.RelativeTimeFormat.supportedLocalesOf(locales)
Intl.RelativeTimeFormat.supportedLocalesOf(locales, options)
Parameter
locales-
Eine Zeichenkette mit einem BCP 47 Sprach-Tag oder ein Array solcher Zeichenketten. Für die allgemeine Form und Interpretation des
localesArguments siehe die Parameterbeschreibung auf derIntlHauptseite. optionsOptional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher-
Der zu verwendende Algorithmus zur Bestimmung der Locale. Mögliche Werte sind
"lookup"und"best fit"; der Standardwert ist"best fit". Für Informationen zu dieser Option siehe die Seite Intl.
Rückgabewert
Ein Array von Zeichenketten, das eine Teilmenge der gegebenen Locale-Tags darstellt, die in der relativen Zeitformatierung unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der relativen Zeitformatierung. supportedLocalesOf gibt die Indonesischen und Deutschen Sprach-Tags unverändert zurück, obwohl die pinyin-Sortierung weder für die relative Zeitformatierung relevant noch mit Indonesisch verwendet wird, und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Angabe des "lookup" Algorithmus hier – ein "best fit" Matcher könnte entscheiden, dass Indonesisch eine ausreichende Übereinstimmung für Balinesisch ist, da die meisten balinesischen Sprecher auch Indonesisch verstehen, und daher auch das Balinesische Sprach-Tag zurückgeben.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-Intl.RelativeTimeFormat.supportedLocalesOf |