JavaScript实现给浮点数添加千分位逗号的多种方法-牛翰网

一、问题背景

在 Web 开发中，我们经常需要在界面上展示财务数据、统计数据或者其他大型数字。为了提升可读性，通常会在整数部分每三位添加一个逗号。例如：

1000 → 1,000
1000000 → 1,000,000
12345678.9 → 12,345,678.9

JavaScript 并没有提供内置的方法直接实现这种格式化，因此我们需要使用正则表达式、toLocaleString() 方法或手动实现格式化逻辑。

二、使用 toLocaleString() 方法

JavaScript 提供了 toLocaleString() 方法，可以直接将数字格式化为带有千分位分隔符的字符串。

const num = 12000000.11;
console.log(num.toLocaleString()); // "12,000,000.11"

该方法默认使用用户所在地区的数字格式。例如，在美国地区，toLocaleString() 会使用逗号作为千分位分隔符，而在部分欧洲地区可能会使用 . 作为分隔符。

如果需要指定格式，可以传递 locales 参数，例如：

console.log(num.toLocaleString('en-US')); // "12,000,000.11"
console.log(num.toLocaleString('de-DE')); // "12.000.000,11"

优点

简洁易用，一行代码即可完成格式化。
自动适配不同地区的格式。

缺点

无法完全自定义格式，例如指定小数位数。
依赖浏览器环境，部分低版本浏览器可能不支持。

三、使用正则表达式实现千分位格式化

如果需要更灵活的控制，可以使用正则表达式手动实现千分位格式化。

function formatNumber(num) {
  const [integer, decimal] = num.toString().split('.');
  return integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',') + (decimal ? '.' + decimal : '');
}

console.log(formatNumber(12000000.11)); // "12,000,000.11"

正则表达式解析

/\B(?=(\d{3})+(?!\d))/g

- \B：匹配非单词边界，确保不会影响开头的数字。
- (?=(\d{3})+(?!\d))：匹配位置，使得每三位数字前加上逗号。

优点

代码量小，性能较高。
适用于所有 JavaScript 运行环境。

缺点

需要对正则表达式有一定的理解。
无法自动适配不同地区的格式。

四、使用 Intl.NumberFormat 进行格式化

JavaScript 提供了 Intl.NumberFormat API，可以用于更加灵活的数值格式化。

const formatter = new Intl.NumberFormat('en-US', {
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});

console.log(formatter.format(12000000.11)); // "12,000,000.11"

优点

提供更强的格式化控制，如小数位数等。
支持国际化。

缺点

需要创建 Intl.NumberFormat 实例。
可能不支持所有浏览器（低版本浏览器需要 polyfill）。

五、手动实现格式化函数

如果想要完全掌控格式化过程，可以使用纯 JavaScript 手动实现：

function formatNumberManual(num) {
  let [integer, decimal] = num.toString().split('.');
  let result = '';
  let count = 0;

  for (let i = integer.length - 1; i >= 0; i--) {
    count++;
    result = integer[i] + result;
    if (count % 3 === 0 && i !== 0) {
      result = ',' + result;
    }
  }

  return decimal ? result + '.' + decimal : result;
}

console.log(formatNumberManual(12000000.11)); // "12,000,000.11"

代码解析

将数字转换为字符串，并拆分整数和小数部分。
通过遍历整数部分，每三位插入一个逗号。
重新组合整数和小数部分。

优点

适用于所有 JavaScript 运行环境。
代码完全可控，可自由调整格式。

缺点

代码较长，需要手动处理每个细节。

六、性能对比

不同方法的性能有所不同，通常情况下：

方法	可读性	性能	兼容性
`toLocaleString()`	高	一般	依赖浏览器
正则表达式	一般	高	兼容性好
`Intl.NumberFormat`	高	高	依赖浏览器
手动实现	低	最高	兼容性好