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 jene der bereitgestellten Locales enthält, die bei der Formatierung von Datum und Uhrzeit unterstützt werden, ohne auf die Standardspracheinstellung der Laufzeitumgebung zurückzugreifen.
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-Sprachcode oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des
locales
-Arguments siehe die Parameterbeschreibung auf derIntl
-Hauptseite. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der zu verwendende Algorithmus zum Abgleichen von Locales. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Für weitere Informationen zu dieser Option siehe die Seite Intl.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der gegebenen Locale-Tags darstellt, die bei der Formatierung von Datum und Uhrzeit unterstützt werden, ohne auf die Standardspracheinstellung der Laufzeitumgebung zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch bei der Formatierung von Datum und Uhrzeit. In diesem Fall gibt supportedLocalesOf
die Sprachcodes für Indonesisch und Deutsch unverändert zurück, auch wenn die pinyin
-Sortierung weder für die Datum- und Zeitformatierung relevant noch für Indonesisch verwendet wird und ein spezialisierter deutscher Locale für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie hier die Spezifikation des "lookup"
-Algorithmus — ein "best fit"
-Matcher könnte entscheiden, dass Indonesisch als ausreichender Ersatz für Balinesisch angesehen werden kann, da die meisten Balinesisch-Sprecher auch Indonesisch verstehen, und daher zusätzlich 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® 2025 Internationalization API Specification # sec-intl.datetimeformat.supportedlocalesof |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
supportedLocalesOf |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- Has more compatibility info.