Exemple interactif

console.log(Intl.supportedValuesOf("calendar"));
console.log(Intl.supportedValuesOf("collation"));
console.log(Intl.supportedValuesOf("currency"));
console.log(Intl.supportedValuesOf("numberingSystem"));
console.log(Intl.supportedValuesOf("timeZone"));
console.log(Intl.supportedValuesOf("unit"));
// Résultat attendu : Array ['key'] (pour chaque clé)

try {
  Intl.supportedValuesOf("uneCléInvalide");
} catch (err) {
  console.log(err.toString());
  // Résultat attendu : RangeError: clé invalide : "uneCl\xE9Invalide"
}

Syntaxe

Intl.supportedValuesOf(key)

Paramètres

key

Une chaîne de caractères qui indique la catégorie de valeurs à retourner. Il s'agit de :

• "calendar" : voir les types de calendriers pris en charge
• "collation" : voir les types de collation pris en charge
• "currency" : voir les identifiants de monnaies pris en charge
• "numberingSystem" : voir les types de systèmes de numérotation pris en charge
• "timeZone" : voir les identifiants de fuseaux horaires pris en charge
• "unit" : voir les identifiants d'unités pris en charge

Valeur de retour

Un tableau trié, contenant des chaînes de caractères uniques indiquant les valeurs prises en charge par l'implémentation pour la clé demandée.

Types de calendriers pris en charge

Voici toutes les valeurs couramment prises en charge par les navigateurs pour la clé calendar. Ces valeurs peuvent être utilisées pour l'option calendar ou la clé d'extension Unicode ca lors de la création d'objets comme Intl.DateTimeFormat, ainsi que pour la création d'objets de date Temporal. Cette liste est explicitement approuvée par la spécification ECMA-402, donc toutes les implémentations devraient être cohérentes.

En octobre 2025, dans le calendrier japanese, les dates antérieures au 23/10/1868 ISO (date de début de l'année 1 Meiji) ne fonctionnent pas comme prévu dans les navigateurs pour deux raisons. Premièrement, CLDR avait la mauvaise date de début pour l'ère Meiji ^(angl.), ce qui fait que les implémentations de calendrier étendent l'ère Meiji plus loin dans le passé qu'elle ne l'était réellement. Deuxièmement, la future proposition Intl era and monthCode ^(angl.) précise que les dates antérieures au 01/01/1873 ISO doivent utiliser les ères grégoriennes, mais les navigateurs ont traditionnellement utilisé des approximations des ères japonaises antérieures. Le calendrier japanese a été adopté le 1er janvier, 6 Meiji / 1873-01-01 ISO, donc ces problèmes n'affectent que les dates proleptiques.

Les types ci-dessous sont spécifiés dans CLDR mais n'ont pas d'implémentations distinctes des calendriers ci-dessus dans les navigateurs.

Les documents Temporal.PlainDate.prototype.era et Temporal.PlainDate.prototype.monthCode fournissent plus d'informations sur les différents calendriers.

Références :

• Clés de type de calendrier CLDR ^(angl.)
• UTS 35, Dates ^(angl.)
• Types de calendrier islamique ^(angl.) (proposition CLDR)

Types de collation pris en charge

Voici toutes les valeurs couramment prises en charge par les navigateurs pour la clé collation. Ces valeurs peuvent être utilisées pour l'option collation ou la clé d'extension Unicode co lors de la création d'objets comme Intl.Collator.

Les types ci-dessous sont définis dans les données CLDR, mais sont obsolètes, déconseillés à l'usage explicite et/ou peuvent ne pas être indiqués comme pris en charge par les navigateurs pour diverses raisons. Évitez de les utiliser :

Références :

• Clés de type de collation CLDR ^(angl.)
• UTS 35, Collation ^(angl.)

Identifiants de monnaies pris en charge

Les identifiants de monnaie sont des codes de trois lettres majuscules définis dans la norme ISO 4217. Ces valeurs peuvent être utilisées pour l'option currency lors de la création d'objets comme Intl.NumberFormat, ainsi que pour Intl.DisplayNames.prototype.of(). Il existe plus de 300 identifiants couramment utilisés, ils ne sont donc pas listés ici. Pour une liste exhaustive des identifiants possibles, consultez l'article Wikipédia.

Références :

• Clés de type de monnaie CLDR ^(angl.)
• Codes de monnaie ISO 4217 ^(angl.)
• UTS 35, Monnaies ^(angl.)

Types de systèmes de numérotation pris en charge

Voici toutes les valeurs couramment prises en charge par les navigateurs pour la clé numberingSystem. Ces valeurs peuvent être utilisées pour l'option numberingSystem ou la clé d'extension Unicode nu lors de la création d'objets comme Intl.NumberFormat. Pour les lignes avec « chiffres », l'exécution traduit les chiffres un par un sans action supplémentaire. Les autres, marquées « algorithmique », nécessitent des algorithmes supplémentaires pour traduire les chiffres. Plus le point de code Unicode est élevé, plus le système de numérotation est récent et plus il est probable qu'il ne soit pas pris en charge par tous les navigateurs.

Il existe trois valeurs spéciales : native, traditio et finance, dont la signification dépend de la locale, et qui seront résolues vers le bon système selon la locale. Par conséquent, les méthodes resolvedOptions() ne retourneront jamais ces valeurs, mais Intl.Locale.prototype.numberingSystem le fera (si elles sont fournies en entrée).

Références :

• Clés de type de système de numérotation CLDR ^(angl.)
• Définitions des systèmes de numérotation CLDR ^(angl.)
• UTS 35, Systèmes de numérotation ^(angl.)

Identifiants de fuseaux horaires pris en charge

Les identifiants de fuseaux horaires pris en charge peuvent être utilisés pour l'option timeZone lors de la création d'objets comme Intl.DateTimeFormat, ainsi que pour la création d'objets de date Temporal. Il existe plus de 400 identifiants couramment utilisés, ils ne sont donc pas listés ici. Pour une liste exhaustive des identifiants possibles, consultez l'article Wikipédia ^(angl.) ou la base de données IANA des fuseaux horaires ^(angl.).

Lorsque vous parcourez la liste, notez que la standardisation de Temporal exige que les navigateurs retournent toujours l'identifiant principal dans la base de données IANA, qui peut évoluer au fil du temps. Voir fuseaux horaires et décalages pour plus d'informations. Par exemple, le tableau retourné doit contenir "Asia/Kolkata" au lieu de "Asia/Calcutta" car ce dernier est un alias du premier et ils correspondent tous deux à l'Inde ; cependant, il doit contenir à la fois "Africa/Abidjan" et "Atlantic/Reykjavik" car ils sont dans des pays différents, bien que le second soit aussi un alias du premier.

Références :

• Base de données IANA des fuseaux horaires ^(angl.)
• UTS 35, Identifiants de fuseaux horaires ^(angl.)

Identifiants d'unités pris en charge

Voici toutes les valeurs couramment prises en charge par les navigateurs pour la clé unit. Ces valeurs peuvent être utilisées pour l'option unit lors de la création d'objets comme Intl.NumberFormat. Cette liste est un sous-ensemble du CLDR explicitement validé par la spécification ECMA-402, donc toutes les implémentations doivent être cohérentes.

• acre
• bit
• byte
• celsius
• centimeter
• day
• degree
• fahrenheit
• fluid-ounce
• foot
• gallon
• gigabit
• gigabyte
• gram
• hectare
• hour
• inch
• kilobit
• kilobyte
• kilogram
• kilometer
• liter
• megabit
• megabyte
• meter
• microsecond
• mile
• mile-scandinavian
• milliliter
• millimeter
• millisecond
• minute
• month
• nanosecond
• ounce
• percent
• petabyte
• pound
• second
• stone
• terabit
• terabyte
• week
• yard
• year

Lors de la spécification des unités, vous pouvez également combiner deux unités avec le séparateur « -per- » (qui signifie « par). Par exemple : meter-per-second ou liter-per-megabyte. Lors de la spécification des unités, vous pouvez également combiner deux unités avec le séparateur « -per- » (qui signifie « par »). Par exemple : meter-per-second ou liter-per-megabyte.

Références :

• Unités validées ECMA-402 ^(angl.)
• Données de validité des unités CLDR ^(angl.)
• UTS 35, Identifiants d'unités ^(angl.)

Exceptions

RangeError

Une clé non prise en charge a été passée en paramètre.

Exemples

Test de fonctionnalité

On peut vérifier que la méthode est prise en charge en la comparant à undefined :

if (typeof Intl.supportedValuesOf !== "undefined") {
  // la méthode est prise en charge
}

Obtenir toutes les valeurs d'une clé donnée

Pour obtenir les valeurs prises en charge pour les représentations calendaires, on pourra appeler la méthode avec la clé "calendar" et parcourir le tableau obtenu :

Intl.supportedValuesOf("calendar").forEach((calendar) => {
  // "buddhist", "chinese", "coptic", "dangi", etc.
});

Les autres valeurs peuvent être obtenues de la même façon :

Intl.supportedValuesOf("collation").forEach((collation) => {
  // "compat", "dict", "emoji", etc.
});

Intl.supportedValuesOf("currency").forEach((currency) => {
  // "ADP", "AED", "AFA", "AFN", "ALK", "ALL", "AMD", etc.
});

Intl.supportedValuesOf("numberingSystem").forEach((numberingSystem) => {
  // "adlm", "ahom", "arab", "arabext", "bali", etc.
});

Intl.supportedValuesOf("timeZone").forEach((timeZone) => {
  // "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", etc.
});

Intl.supportedValuesOf("unit").forEach((unit) => {
  // "acre", "bit", "byte", "celsius", "centimeter", etc.
});

Exception à l'utilisation d'une clé invalide

try {
  Intl.supportedValuesOf("uneCleInvalide");
} catch (err) {
  // Error: RangeError: invalid key: "uneCleInvalide"
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• Prothèse d'émulation pour Intl.supportedValuesOf dans FormatJS ^(angl.)
• L'objet Intl