JavaScript中toLocaleString数字格式化处理详解

作者:橙子

时间:2026-10-26

浏览:259

本文详解JavaScript中Number.prototype.toLocaleString方法的用法,涵盖千分位分割、小数位数控制、有效数字处理及货币与单位格式设置。通过具体参数示例,展示如何快速实现金融级数字格式化,避免手动编写复杂逻辑。

文章目录

toLocaleString 偷懒小帮手啊~

在开发项目中,对数字进行格式化处理是极为常见的场景,尤其在涉及金融数据时更为关键。以往遇到不同格式需求时,往往需要手动编写函数来处理,这不仅耗时且容易出错。近期发现 toLocaleString 函数功能强大,若早点知晓,便能避免大量重复劳动。

Number.prototype.toLocaleString()

参数: numObj.toLocaleString([locales [, options]])。

第一个参数为可选,接受缩写语言代码(BCP 47 language tag,例如: cmn-Hans-CN)的字符串或由这些字符串组成的数组。部分 Unicode 扩展键也被允许,具体细节可参考 MDN 文档。若需特殊地区格式,需传入当地的locales。通常传入undefined、zh或en即可满足大多数场景,默认不传时值为undefiend。

1. 数字分割成千分位

直接调用该方法时,默认行为即为将数字分割为千分位格式。

var a = 123456.6789
a.toLocaleString() // 123,456.679,默认保留3位小数

若不希望数字被分割为千分位,则需要使用属性useGrouping: false。

var a = 123456.6789
a.toLocaleString(undefined, {useGrouping: false}) // 123456.6789

2. 保留几位小数

此功能主要依赖两个属性:控制最少小数位数的minimumFractionDigits和控制最多小数位数的maximumFractionDigits。

var a = 123456.6789
a.toLocaleString(undefined, {minimumFractionDigits: 6}) //123,456.678900

若将最少保留数设为6,则结果会强制保留6位小数。

var a = 123456.6789
a.toLocaleString(undefined, {maximumFractionDigits: 2}) //123,456.68

若仅需保留两位小数,只需将保留最多小数数设为2即可。

3. 使用的整数数字的最小数目minimumIntegerDigits

该属性取值范围为1-21,默认值为1。

var a = 123456.6789
a.toLocaleString(undefined, {minimumIntegerDigits: 8}) //00,123,456.679

它用于指定使用的整数数字的最小数目,若不足指定位数,则自动补零。

4. 使用的有效数字的最小数目minimumSignificantDigits

该属性取值范围为1-21,默认值为1。

var a = 123456.6789
a.toLocaleString(undefined, {minimumIntegerDigits: 8}) //00,123,456.679

5. 使用的有效数字的最大数目maximumSignificantDigits

该属性取值范围为1-21,默认值为21。

var a = 123456.6789
a.toLocaleString(undefined, {maximumSignificantDigits: 6}) //123,457

4.5两个保留有效位的属性也很厉害,可以保留任意有效位,四舍五入,不足位的会补零。

6. 展示的样式style

属性style用于指定不同的展示样式选项:默认值为decimal。可选选项包括:

decimal: 纯数字

percent: 百分比

unit: 单位格式,需配合unit使用,指定单位类型。

currency: 用于货币格式,注意此属性不能单独使用,还需配套使用currency属性。

var a = 123456.6789, 
a.toLocaleString(undefined, {style: 'decimal'}) //123,456.679
a.toLocaleString(undefined, {style: 'percent'}) // 12,345,668%
a.toLocaleString(undefined, {style: 'currency', currency: 'EUR'}) // €123,456.68
a.toLocaleString(undefined, {style: 'currency', currency: 'CNY'}) // ¥123,456.68
a.toLocaleString(undefined, {style: 'unit', unit: 'acre'}) // 123,456.679英亩

其中currency和currencyDisplay也可配合使用,前者指定对应货币,如USD、EUR与CNY(不区分大小写),后者指定货币符号的展示样式,默认值为currencyDisplay:symbol:

var a = 123456.6789, 
a.toLocaleString(undefined, {style: 'currency', currency: 'CNY', currencyDisplay: 'symbol'}) //  ¥123,456.68
a.toLocaleString(undefined, {style: 'currency', currency: 'CNY', currencyDisplay: 'code'}) // CNY 123,456.68
a.toLocaleString(undefined, {style: 'currency', currency: 'CNY', currencyDisplay: 'name'}) // 123,456.68人民币

以上均为toLocaleString对数字的常规格式化处理,足以应对日常开发中的格式需求。

此外,该方法还有Date.prototype.toLocaleString和Array.prototype.toLocaleString等相关用法,感兴趣者可自行查阅文档了解。

以上就是JavaScript中使用toLocaleString数字格式化处理详解的详细内容,更多关于toLocaleString数字格式化的资料请关注本站其它相关文章!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章