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 formatRange() Methode von Intl.NumberFormat Instanzen formatiert einen Zahlenbereich gemäß den lokalen und den Formatierungsoptionen dieses Intl.NumberFormat Objekts.

Syntax

formatRange(startRange, endRange)

Parameter

startRange: Eine Number, BigInt oder ein String, um formatiert zu werden. Strings werden auf die gleiche Weise wie bei der Zahlenumwandlung analysiert, mit der Ausnahme, dass formatRange() den exakten Wert verwendet, den der String darstellt, um Präzisionsverluste bei der impliziten Umwandlung in eine Zahl zu vermeiden.
endRange: Eine Number, BigInt oder ein String, um formatiert zu werden.

Ein String, der den angegebenen Bereich von Zahlen darstellt, formatiert gemäß den lokalen und den Formatierungsoptionen dieses Intl.NumberFormat Objekts. Wenn die Start- und Endwerte zum gleichen String formatiert werden, enthält die Ausgabe nur einen einzigen Wert, möglicherweise mit einem "ungefähr gleich"-Symbol (z. B. "~$3") vorangestellt. Die Einfügung dieses Symbols hängt ausschließlich von den lokalen Einstellungen ab und wird auch eingefügt, wenn startRange === endRange.

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.

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 €"