Intl.NumberFormat.prototype.formatRange()

formatRange() 方法是 Intl.NumberFormat 实例的一个方法，它根据此 Intl.NumberFormat 对象的区域设置和格式选项来格式化一系列数字。

语法

formatRange(startRange, endRange)

参数

startRange: 一个 Number 或 BigInt。
endRange: 一个 Number 或 BigInt。

返回值

一个字符串，表示根据此 Intl.NumberFormat 对象的区域设置和格式选项格式化的一系列数字。

异常

RangeError: 如果 startRange 小于 endRange，或者任一值是 NaN，则抛出。
TypeError: 如果 startRange 或 endRange 未定义，则抛出。

描述

formatRange 获取器函数根据调用它的 Intl.NumberFormat 对象的区域设置和格式选项，将一系列数字格式化为字符串。

示例

使用 formatRange

使用 formatRange 获取器函数来格式化一系列货币值

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

规范

规范
ECMAScript 国际化 API 规范 # sec-intl.numberformat.prototype.formatrange

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。