JavaScript Number toLocaleString() 方法

在 JavaScript 中，数字类型可以使用 toLocaleString() 方法将数字转换为本地化格式的字符串。这个方法直接作用于 Number 对象，不需要通过 new 运算符来创建实例。

语法

numObj.toLocaleString([locales[, options]]);

参数

locales（可选）：字符串或字符串数组，指定用于区域设置的地区、语言等信息。

options（可选）：一个对象，包含以下属性：

• localeMatcher：指定如何匹配区域设置，默认值为 'best fit'。
• style：指定要使用的数字格式风格，可选值为 'decimal'（十进制），'currency'（货币）和 'percent'（百分比），默认值为 'decimal'。
• currency：指定货币格式的货币代码，当 style 为 'currency' 时必须指定。
• currencyDisplay：指定货币格式中货币符号的显示方式。
• useGrouping：是否使用分组分隔符，默认值为 true。
• minimumIntegerDigits：指定整数部分的最小位数。
• minimumFractionDigits：指定小数部分的最小位数。
• maximumFractionDigits：指定小数部分的最大位数。
• minimumSignificantDigits：指定有效数字的最小位数。
• maximumSignificantDigits：指定有效数字的最大位数。

这些属性的详细说明可以参见 ECMAScript Internationalization API Specification。

返回值

一个字符串，代表转换后的本地化数值字符串。

示例

const num1 = 1234.567;
const num2 = 1234567;

console.log(num1.toLocaleString());
// output: '1,234.567'

console.log(num2.toLocaleString('en-US'));
// output: '1,234,567'

console.log(num1.toLocaleString('de-DE', { style: 'currency', currency: 'EUR' }));
// output: '1.234,57 €'

console.log(num2.toLocaleString('ja-JP', { style: 'percent' }));
// output: '123,456,700%'

以上示例展示了 toLocaleString() 方法的基本用法。可以看到，使用该方法可以方便地将数字转换为本地化格式的字符串。

注意事项

• toLocaleString() 方法并不会直接更改原始数值，而是返回一个新的字符串。
• toLocaleString() 方法在不同的浏览器和系统上可能会有不同的实现。需要按需兼容和测试。