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 bereitgestellten und in der relativen Zeitformatierung unterstützten Lokalisierungen enthält, ohne auf die Standardlokalisierung der Laufzeitumgebung zurückgreifen zu müssen.
Probieren Sie es aus
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// 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
-
Ein Zeichenfolgen mit einem BCP 47-Sprach-Tag oder ein Array solcher Zeichenfolgen. Für die allgemeine Form und Interpretation des
locales
-Arguments siehe die Parameterbeschreibung auf der Hauptseite vonIntl
. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der zu verwendende Algorithmus zur Lokalisierungssuche. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Für Informationen über diese Option siehe die Seite Intl.
Rückgabewert
Ein Array von Zeichenfolgen, das eine Teilmenge der angegebenen Lokalisierungs-Tags darstellt, die in der relativen Zeitformatierung unterstützt werden, ohne auf die Standardlokalisierung der Laufzeitumgebung zurückzugreifen.
Beispiele
>Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der relativen Zeitformatierung, gibt supportedLocalesOf
die Sprach-Tags für Indonesisch und Deutsch unverändert zurück, obwohl die pinyin
-Sortierung weder relevant für die relative Zeitformatierung ist 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 angemessene Übereinstimmung für Balinesisch ist, da die meisten Balinesischsprecher auch Indonesisch verstehen, und daher das balinesische Sprach-Tag ebenfalls 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> |
Browser-Kompatibilität
Loading…