Intl.NumberFormat.prototype.formatRange()
Die formatRange()
Methode von Intl.NumberFormat
Instanzen formatiert einen Zahlenbereich gemäß den lokalen und Formatierungsoptionen dieses Intl.NumberFormat
Objekts.
Syntax
formatRange(startRange, endRange)
Parameter
startRange
-
Eine
Number
, einBigInt
, oder ein String, der formatiert werden soll. Strings werden auf die gleiche Weise wie bei der Zahlenkonvertierung geparst, mit dem Unterschied, dassformatRange()
den genauen Wert verwendet, den der String darstellt, um einen Genauigkeitsverlust während der impliziten Umwandlung in eine Zahl zu vermeiden. endRange
-
Eine
Number
, einBigInt
, 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
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 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:
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 Internationalization API Specification # sec-intl.numberformat.prototype.formatrange |
Browser-Kompatibilität
BCD tables only load in the browser