Intl.NumberFormat.prototype.formatRange()

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.

Rückgabewert

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.

Beschreibung

Die formatRange Getter-Funktion formatiert einen Bereich von Zahlen zu einem String gemäß den lokalen und den Formatierungsoptionen dieses 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

Browser-Kompatibilität

Siehe auch

• Intl.NumberFormat
• Number.prototype.toLocaleString()