在线文档教程

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是否使用分组分隔符,如千位分隔符或千位/十万位/分位符分隔符。可能的值是truefalse; 默认是true

以下性质分为两组:minimumIntegerDigitsminimumFractionDigits,和maximumFractionDigits在一组中,minimumSignificantDigits并且maximumSignificantDigits在其他。如果至少定义了第二组中的一个属性,那么第一个组将被忽略。

minimumIntegerDigits要使用的最小整数位数。可能的值从1到21; 默认值是1. minimumFractionDigits使用的最小小数位数。可能的值是从0到20; 普通数字和百分比格式的默认值是0; 货币格式化的默认值是由ISO 4217货币代码列表提供的次要单位数字(如果列表不提供该信息,则为2)。maximumFractionDigits要使用的最大小数位数。可能的值是从0到20; 普通数字格式的默认值是minimumFractionDigits3和3中较大的一个; 货币格式化的默认值是ISO 4217货币代码清单所minimumFractionDigits提供的较小单位数和较小单位数(2如果名单不提供这些信息); 格式百分比的默认值是minimumFractionDigits0和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"

规范

SpecificationStatusComment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'TypedArray.prototype.toLocaleString' in that specification.StandardInitial definition.
ECMAScript 2017 Draft (ECMA-262)The definition of 'TypedArray.prototype.toLocaleString' in that specification.Draft

浏览器兼容性

FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support(Yes)51 (51)(Yes)(Yes)(Yes)

FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support(Yes)(Yes)51.0 (51)(Yes)(Yes)(Yes)