Intl.DurationFormat.supportedLocalesOf()
Baseline 2025Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Die Intl.DurationFormat.supportedLocalesOf()
statische Methode gibt ein Array zurück, das diejenigen der bereitgestellten Locales enthält, die in der Dauerformatierung unterstützt werden, ohne auf die Standard-Locales der Laufzeitumgebung zurückgreifen zu müssen.
Syntax
Intl.DurationFormat.supportedLocalesOf(locales)
Intl.DurationFormat.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 derIntl
Hauptseite. options
Optional-
Ein Objekt, das die folgende Eigenschaft enthalten kann:
localeMatcher
-
Der zu verwendende Locale-Abgleichsalgorithmus. 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 repräsentiert, die in der Dauerformatierung unterstützt werden, ohne auf die Standard-Locales der Laufzeitumgebung zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Dauerformatierung, gibt supportedLocalesOf
die indonesischen und deutschen Sprach-Tags unverändert zurück, obwohl pinyin
-Kollation weder für die Dauerformatierung relevant 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 ein angemessener Ersatz für Balinesisch ist, da die meisten Balinesisch-Sprecher auch Indonesisch verstehen, und daher auch das balinesische Sprach-Tag zurückgeben könnte.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.DurationFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
Specification |
---|
Intl.DurationFormat # sec-Intl.DurationFormat.supportedLocalesOf |