Intl.RelativeTimeFormat : méthode statique supportedLocalesOf()

Exemple interactif

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

console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales1, options1));
// Résultat attendu : Array ["id-u-co-pinyin", "de-ID"]
// (Note : le résultat exact peut dépendre du navigateur)

Syntaxe

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

Paramètres

locales

Une chaîne de caractères avec une balise de langue BCP 47, ou un tableau de telles chaînes de caractères. Pour la forme générale et l'interprétation de l'argument locales, voir la description du paramètre sur la page principale de Intl.

options Facultatif

Un objet pouvant avoir la propriété suivante :

localeMatcher

L'algorithme de correspondance entre locales à utiliser. Les valeurs possibles sont "lookup" et "best fit" ; la valeur par défaut est "best fit". Pour plus d'informations sur cette option, voir la page Intl.

Valeur de retour

Un tableau de chaînes de caractères représentant un sous-ensemble des balises de langue fournies qui sont prises en charge pour le formatage du temps relatif sans avoir à utiliser la locale par défaut de l'environnement d'exécution.

Exemples

Utiliser la méthode supportedLocalesOf()

En supposant un environnement d'exécution qui prend en charge l'indonésien et l'allemand mais pas le balinais pour le formatage du temps relatif, supportedLocalesOf retourne les balises de langue indonésienne et allemande inchangées, même si la collation pinyin n'est ni pertinente pour le formatage du temps relatif ni utilisée avec l'indonésien, et qu'un allemand spécialisé pour l'Indonésie est peu probable. Notez la spécification de l'algorithme "lookup" ici — une correspondance "best fit" peut décider que l'indonésien est un match adéquat pour le balinais puisque la plupart des locuteurs balinais comprennent également l'indonésien, et donc retourner également la balise de langue balinaise.

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"]

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Intl.RelativeTimeFormat