Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Intl.RelativeTimeFormat.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 2020⁩.

Die statische Methode Intl.RelativeTimeFormat.supportedLocalesOf() gibt ein Array zurück, das die bereitgestellten und in der relativen Zeitformatierung unterstützten Lokalisierungen enthält, ohne auf die Standardlokalisierung der Laufzeitumgebung zurückgreifen zu müssen.

Probieren Sie es aus

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };

console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)

Syntax

js
Intl.RelativeTimeFormat.supportedLocalesOf(locales)
Intl.RelativeTimeFormat.supportedLocalesOf(locales, options)

Parameter

locales

Ein Zeichenfolgen mit einem BCP 47-Sprach-Tag oder ein Array solcher Zeichenfolgen. 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 Algorithmus zur Lokalisierungssuche. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Für Informationen über diese Option siehe die Seite Intl.

Rückgabewert

Ein Array von Zeichenfolgen, das eine Teilmenge der angegebenen Lokalisierungs-Tags darstellt, die in der relativen Zeitformatierung unterstützt werden, ohne auf die Standardlokalisierung der Laufzeitumgebung zurückzugreifen.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der relativen Zeitformatierung, gibt supportedLocalesOf die Sprach-Tags für Indonesisch und Deutsch unverändert zurück, obwohl die pinyin-Sortierung weder relevant für die relative Zeitformatierung ist noch mit Indonesisch verwendet wird, und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Angabe des "lookup"-Algorithmus 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.

js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.RelativeTimeFormat.supportedLocalesOf

Browser-Kompatibilität

Siehe auch