typedArray.toLocaleString
typedArray.toLocaleString
toLocaleString()
方法返回一个表示类型数组元素的字符串。元素被转换为字符串,并被一个特定于语言环境的字符串(如逗号“,”)分隔。这个方法与算法相同,Array.prototype.toLocaleString()
而且,由于类型化数组元素是数字,所以与Number.prototype.toLocaleString()
每个元素适用的算法相同。TypedArray
是这里的类型数组类型之一。
语法
typedarray.toLocaleString([locales [, options]]
参数
locales
可选的。一个带有BCP 47语言标签的字符串或这种字符串的数组。有关参数的一般形式和解释locales
,请参阅Intl页面。以下Unicode扩展键是被允许的:
nu
要使用的编号系统。可能的值包括:"arab"
,"arabext"
,"bali"
,"beng"
,"deva"
,"fullwide"
,"gujr"
,"guru"
,"hanidec"
,"khmr"
,"knda"
,"laoo"
,"latn"
,"limb"
,"mlym"
,"mong"
,"mymr"
,"orya"
,"tamldec"
,"telu"
,"thai"
,"tibt"
。options
可选的。具有部分或全部以下属性的对象:
localeMatcher
要使用的语言环境匹配算法。可能的值是"lookup"
和"best fit"
; 默认是"best fit"
。有关此选项的信息,请参阅Intl页面。style
要使用的格式化样式。可能的值为"decimal"
普通数字格式,"currency"
货币格式和"percent"
百分比格式; 默认是"decimal"
。currency
货币格式中使用的货币。可能的值是ISO 4217货币代码,例如"USD"
美元,"EUR"
欧元或"CNY"
中国人民币 - 请参阅当前货币和资金代码列表。没有默认值; 如果style
是"currency"
,则currency
必须提供该财产。currencyDisplay
如何以货币格式显示货币。可能的值是"symbol"
使用局部货币符号如€,"code"
使用ISO货币代码,"name"
以使用当地货币的名称,如"dollar"
; 默认是"symbol"
。useGrouping
是否使用分组分隔符,如千位分隔符或千位/十万位/分位符分隔符。可能的值是true
和false
; 默认是true
。
以下性质分为两组:minimumIntegerDigits
,minimumFractionDigits
,和maximumFractionDigits
在一组中,minimumSignificantDigits
并且maximumSignificantDigits
在其他。如果至少定义了第二组中的一个属性,那么第一个组将被忽略。
minimumIntegerDigits
要使用的最小整数位数。可能的值从1到21; 默认值是1. minimumFractionDigits
使用的最小小数位数。可能的值是从0到20; 普通数字和百分比格式的默认值是0; 货币格式化的默认值是由ISO 4217货币代码列表提供的次要单位数字(如果列表不提供该信息,则为2)。maximumFractionDigits
要使用的最大小数位数。可能的值是从0到20; 普通数字格式的默认值是minimumFractionDigits
3和3中较大的一个; 货币格式化的默认值是ISO 4217货币代码清单所minimumFractionDigits
提供的较小单位数和较小单位数(2如果名单不提供这些信息); 格式百分比的默认值是minimumFractionDigits
0和0中的较大者minimumSignificantDigits
。使用的最小有效位数。可能的值从1到21; 缺省值是1. maximumSignificantDigits
使用的最大有效位数。可能的值从1到21; 默认是minimumSignificantDigits
。
返回值
表示类型数组的元素的字符串。
示例
使用toLocaleString
var uint = new Uint32Array([2000, 500, 8123, 12, 4212]
uint.toLocaleString(
// if run in a de-DE locale
// "2.000,500,8.123,12,4.212"
uint.toLocaleString('en-US'
// "2,000,500,8,123,12,4,212"
uint.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }
// "¥2,000,¥500,¥8,123,¥12,¥4,212"
规范
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'TypedArray.prototype.toLocaleString' in that specification. | Standard | Initial definition. |
ECMAScript 2017 Draft (ECMA-262)The definition of 'TypedArray.prototype.toLocaleString' in that specification. | Draft | |
浏览器兼容性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | 51 (51) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 51.0 (51) | (Yes) | (Yes) | (Yes) |