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 jene der bereitgestellten Locale enthält, die in der relativen Zeitformatierung unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.
Probieren Sie es aus
Syntax
Intl.RelativeTimeFormat.supportedLocalesOf(locales)
Intl.RelativeTimeFormat.supportedLocalesOf(locales, options)
Parameter
locales
-
Ein String mit einem BCP 47-Sprach-Tag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des
locales
-Parameters siehe die Parameterbeschreibung auf derIntl
-Hauptseite. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der zu verwendende Algorithmus zur Locale-Abstimmung. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Für Informationen zu dieser Option siehe die Intl-Seite.
Rückgabewert
Ein Array von Strings, das eine Untermenge 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()
Wenn eine Laufzeitumgebung Indonesisch und Deutsch, aber nicht Balinesisch in der relativen Zeitformatierung unterstützt, gibt supportedLocalesOf
die Sprach-Tags für Indonesisch und Deutsch unverändert zurück, selbst wenn die pinyin
-Kollation weder in der relativen Zeitformatierung relevant ist noch mit Indonesisch verwendet wird, und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Spezifikation des "lookup"
-Algorithmus hier — ein "best fit"
-Matcher könnte entscheiden, dass Indonesisch eine ausreichende Entsprechung für Balinesisch ist, da die meisten Balinesisch-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 Internationalization API Specification # sec-Intl.RelativeTimeFormat.supportedLocalesOf |
Browser-Kompatibilität
BCD tables only load in the browser