Intl.NumberFormat.prototype.formatRange()

La méthode Intl.NumberFormat.prototype.formatRange() formate un intervalle numérique selon la locale et les options de formatage associées à l'objet Intl.NumberFormat sur lequel la méthode est appelée.

Syntaxe

js
formatRange(debutIntervalle, finIntervalle);

Paramètres

debutIntervalle

Une valeur numérique Number ou BigInt.

finIntervalle

Une valeur numérique Number ou BigInt.

Description

L'accesseur formatRange donne une fonction qui formate un intervalle numérique en une chaîne de caractères selon les options de locale et de formatage associées à l'objet Intl.NumberFormat sur lequel il est appelé.

Exemples

Utiliser formatRange()

On utilise ici la fonction formatRange() pour formater un intervalle de valeurs représentant des montants en devises :

js
const nf = new Intl.NumberFormat("en-US", {
  style: "currency",
  currency: "USD",
  maximumFractionDigits: 0,
});

console.log(nf.formatRange(3, 5)); // → "$3 - $5"
console.log(nf.formatRange(2.9, 3.1)); // → "~$3"
js
const nf = new Intl.NumberFormat("es-ES", {
  style: "currency",
  currency: "EUR",
  maximumFractionDigits: 0,
});

console.log(nf.formatRange(3, 5); // → "3-5 €"
console.log(nf.formatRange(2.9, 3.1); // → "~3 €"

Spécifications

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-intl.numberformat.prototype.formatrange

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
formatRange

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Voir aussi