Intl.NumberFormat.prototype.formatRange()

Die formatRange() Methode von Intl.NumberFormat Instanzen formatiert einen Zahlenbereich gemäß den lokalen und Formatierungsoptionen dieses Intl.NumberFormat Objekts.

Syntax

js
formatRange(startRange, endRange)

Parameter

startRange

Eine Number, ein BigInt, oder ein String, der formatiert werden soll. Strings werden auf die gleiche Weise wie bei der Zahlenkonvertierung geparst, mit dem Unterschied, dass formatRange() den genauen Wert verwendet, den der String darstellt, um einen Genauigkeitsverlust während der impliziten Umwandlung in eine Zahl zu vermeiden.

endRange

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

Rückgabewert

Ein String, der den angegebenen Zahlenbereich darstellt, formatiert gemäß den lokalen und Formatierungsoptionen dieses Intl.NumberFormat Objekts.

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 Zahlenbereich in einen String gemäß den lokalen und Formatierungsoptionen dieses Intl.NumberFormat Objekts, von dem er aufgerufen wird.

Beispiele

Verwendung von formatRange

Verwenden Sie die formatRange Getter-Funktion zur Formatierung eines Bereichs von Währungswerten:

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