Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Intl.DurationFormat : méthode statique supportedLocalesOf()

Baseline 2025
Newly available

Depuis March 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode statique supportedLocalesOf() des instances de Intl.DurationFormat retourne un tableau contenant celles des locales fournies qui sont prises en charge pour le formatage de durée sans avoir à revenir à la locale par défaut de l'environnement d'exécution.

Syntaxe

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

Paramètres

locales

Une chaîne de caractères avec une balise BCP 47 language tag, ou un tableau de telles chaînes. 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 qui peut avoir la propriété suivante :

localeMatcher

L'algorithme de correspondance de locale à 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 locale fournies qui sont prises en charge pour le formatage de durée sans avoir à revenir à 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 de durée, 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 de durée ni utilisée avec l'indonésien, et qu'un allemand spécialisé pour l'Indonésie est peu susceptible d'être pris en charge. Notez la spécification de l'algorithme "lookup" ici — un comparateur "best fit" pourrait décider que l'indonésien est une correspondance adéquate pour le balinais puisque la plupart des locuteurs balinais comprennent aussi l'indonésien, et donc retourner également la balise de langue balinaise.

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

Spécifications

Specification
Intl.DurationFormat
# sec-Intl.DurationFormat.supportedLocalesOf

Compatibilité des navigateurs

Voir aussi