Intl.NumberFormat.prototype.formatRange()
Baseline 2023Newly 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
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 dassformatRange()
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
oderendRange
NaN
oder ein nicht konvertierbarer String ist. TypeError
-
Wird ausgelöst, wenn entweder
startRange
oderendRange
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:
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"
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 |