Intl.NumberFormat.prototype.formatRange()

Die Methode formatRange() von Intl.NumberFormat-Instanzen formatiert einen Bereich von Zahlen gemäß der Lokalisierung und den Formatierungsoptionen dieses Intl.NumberFormat-Objekts.

Syntax

js
formatRange(startRange, endRange)

Parameter

startRange

Eine Number oder BigInt.

endRange

Eine Number oder BigInt.

Rückgabewert

Ein String, der den angegebenen Bereich von Zahlen darstellt, formatiert gemäß der Lokalisierung und den Formatierungsoptionen dieses Intl.NumberFormat-Objekts.

Ausnahmen

RangeError

Wird ausgelöst, wenn startRange kleiner als endRange ist oder einer der Werte NaN ist.

TypeError

Wird ausgelöst, wenn entweder startRange oder endRange undefiniert ist.

Beschreibung

Die formatRange-Getter-Funktion formatiert einen Bereich von Zahlen in einen String gemäß der Lokalisierung und den Formatierungsoptionen dieses Intl.NumberFormat-Objekts, von dem sie aufgerufen wird.

Beispiele

Verwendung von formatRange

Verwenden Sie die formatRange-Getter-Funktion, um einen Bereich von Währungswerten zu formatieren:

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

console.log(nf.formatRange(3, 5)); // "$3 – $5"

// Note: the "approximately equals" symbol is added if
// startRange and endRange round to the same values.
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 €"

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch