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 diejenigen der angegebenen locales enthält, die in der Datums- und Uhrzeitformatierung unterstützt werden, ohne auf die standardmäßige Laufzeitumgebung-Locale zurückfallen zu müssen.
Probieren Sie es aus
const locales1 = ["ban", "id-u-co-pinyin", "de-ID"];
const options1 = { localeMatcher: "lookup" };
console.log(Intl.DateTimeFormat.supportedLocalesOf(locales1, options1));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)
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. optionsOptional-
Ein Objekt, das folgende Eigenschaft haben kann:
localeMatcher-
Der zu verwendende Locale-Abgleichalgorithmus. 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 Strings, das eine Teilmenge der angegebenen Locale-Tags darstellt, die in der Datums- und Uhrzeitformatierung unterstützt werden, ohne auf die standardmäßige Laufzeitumgebung-Locale zurückfallen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Datums- und Uhrzeitformatierung, gibt supportedLocalesOf die indonesischen und deutschen Sprachtags unverändert zurück, auch wenn die pinyin-Sortierung weder für die Datums- und Uhrzeitformatierung 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 geeignete Übereinstimmung für Balinesisch ist, da die meisten balinesischen Sprecher auch Indonesisch verstehen, und daher auch das balinesische Sprachtag 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® 2026 Internationalization API Specification # sec-intl.datetimeformat.supportedlocalesof |