Intl.DateTimeFormat.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 2017.
Die statische Methode Intl.DateTimeFormat.supportedLocalesOf()
gibt ein Array zurück, das die von den angegebenen Locales enthält, die bei der Datums- und Zeitformatierung unterstützt werden, ohne dass auf die Standardspracheinstellung der Laufzeitumgebung zurückgegriffen werden muss.
Probieren Sie es aus
Syntax
Intl.DateTimeFormat.supportedLocalesOf(locales)
Intl.DateTimeFormat.supportedLocalesOf(locales, options)
Parameter
locales
-
Ein String mit einem BCP 47-Sprachtag oder ein Array solcher Strings. 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 Locale-Matching-Algorithmus. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Weitere Informationen zu dieser Option finden Sie auf der Intl-Seite.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der angegebenen Locale-Tags darstellt, die bei der Datums- und Zeitformatierung unterstützt werden, ohne dass auf die Standardspracheinstellung der Laufzeitumgebung zurückgegriffen werden muss.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch bei der Datums- und Zeitformatierung. supportedLocalesOf
gibt die indonesischen und deutschen Sprachtags unverändert zurück, auch wenn pinyin
-Kollation weder für die Datums- und Zeitformatierung relevant ist noch mit Indonesisch verwendet wird, und ein spezielles Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie hier die Angabe des "lookup"
-Algorithmus — ein "best fit"
-Matcher könnte entscheiden, dass Indonesisch eine angemessene Übereinstimmung für Balinesisch ist, da die meisten Balinesischsprachigen 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.DateTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
Specification |
---|
ECMAScript Internationalization API Specification # sec-intl.datetimeformat.supportedlocalesof |
Browser-Kompatibilität
BCD tables only load in the browser