Intl.NumberFormat.prototype.formatRange()

Baseline 2023
Newly available

Since August 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die Methode formatRange() von Intl.NumberFormat-Instanzen formatiert einen Bereich von Zahlen entsprechend der Lokalisierungs- und Formatierungsoptionen dieses Intl.NumberFormat-Objekts.

Syntax

js
formatRange(startRange, endRange)

Parameter

startRange

Eine Number, BigInt oder ein String, der formatiert werden soll. Strings werden auf die gleiche Weise geparst wie bei der Zahlenkonvertierung, außer dass formatRange() den genauen Wert des Strings verwendet, um einen Präzisionsverlust bei der impliziten Umwandlung in eine Zahl zu vermeiden.

endRange

Eine Number, BigInt oder ein String, der formatiert werden soll.

Rückgabewert

Ein String, der den angegebenen Zahlenbereich entsprechend der Lokalisierungs- und Formatierungsoptionen dieses Intl.NumberFormat-Objekts formatiert darstellt.

Ausnahmen

RangeError

Wird ausgelöst, wenn entweder startRange oder endRange NaN oder ein nicht konvertierbarer String ist.

TypeError

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

Beschreibung

Die formatRange-Getter-Funktion formatiert einen Bereich von Zahlen als String gemäß der Lokalisierungs- und Formatierungsoptionen des 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® 2026 Internationalization API Specification
# sec-intl.numberformat.prototype.formatrange

Browser-Kompatibilität

Siehe auch