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 bereitgestellten Locales enthält, die in der Datums- und Zeitformatierung unterstützt werden, ohne auf die Standardlocale der Laufzeitumgebung zurückgreifen 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-Sprach-Tag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des locales-Arguments siehe die Parameterbeschreibung auf der Hauptseite von Intl.

options Optional

Ein Objekt, das die 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 über diese Option siehe die Intl-Seite.

Rückgabewert

Ein Array von Strings, das eine Teilmenge der angegebenen Locale-Tags darstellt, die in der Datums- und Zeitformatierung unterstützt werden, ohne auf die Standardlocale der Laufzeitumgebung zurückgreifen zu müssen.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen, es gibt eine Laufzeitumgebung, die Indonesisch und Deutsch unterstützt, aber nicht Balinesisch in der Datums- und Zeitformatierung, gibt supportedLocalesOf die indonesischen und deutschen Sprach-Tags unverändert zurück, obwohl die pinyin-Kollation weder für die Datums- und Zeitformatierung relevant ist noch mit Indonesisch verwendet wird, und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Angabe des Algorithmus "lookup" 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.DateTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification # sec-intl.datetimeformat.supportedlocalesof

Browser-Kompatibilität

Siehe auch

Intl.DateTimeFormat