在此页

• 句法
• Polyfill
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

toLocaleString() method returns a string representing the elements of the array. The elements are converted to Strings using their toLocaleString methods and these Strings are separated by a locale-specific String (such as a comma “,”).

句法

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

参数

locales 可选

A string with a BCP 47 language tag, or an array of such strings. For the general form and interpretation of the locales argument, see the Intl 页面。

options 可选

An object with configuration properties, for numbers see Number.prototype.toLocaleString() , and for dates see Date.prototype.toLocaleString() .

返回值

A string representing the elements of the array.

Polyfill

// https://tc39.github.io/ecma402/#sup-array.prototype.tolocalestring
if (!Array.prototype.toLocaleString) {
  Object.defineProperty(Array.prototype, 'toLocaleString', {
    value: function(locales, options) {
      // 1. Let O be ? ToObject(this value).
      if (this == null) {
        throw new TypeError('"this" is null or not defined');
      }
      var a = Object(this);
      // 2. Let len be ? ToLength(? Get(A, "length")).
      var len = a.length >>> 0;
      // 3. Let separator be the String value for the
      //    list-separator String appropriate for the
      //    host environment's current locale (this is
      //    derived in an implementation-defined way).
      // NOTE: In this case, we will use a comma
      var separator = ',';
      // 4. If len is zero, return the empty String.
      if (len === 0) {
        return '';
      }
      // 5. Let firstElement be ? Get(A, "0").
      var firstElement = a[0];
      // 6. If firstElement is undefined or null, then
      //  a.Let R be the empty String.
      // 7. Else,
      //  a. Let R be ?
      //     ToString(?
      //       Invoke(
      //        firstElement,
      //        "toLocaleString",
      //        « locales, options »
      //       )
      //     )
      var r = firstElement == null ?
        '' : firstElement.toLocaleString(locales, options);
      // 8. Let k be 1.
      var k = 1;
      // 9. Repeat, while k < len
      while (k < len) {
        // a. Let S be a String value produced by
        //   concatenating R and separator.
        var s = r + separator;
        // b. Let nextElement be ? Get(A, ToString(k)).
        var nextElement = a[k];
        // c. If nextElement is undefined or null, then
        //   i. Let R be the empty String.
        // d. Else,
        //   i. Let R be ?
        //     ToString(?
        //       Invoke(
        //        nextElement,
        //        "toLocaleString",
        //        « locales, options »
        //       )
        //     )
        r = nextElement == null ?
          '' : nextElement.toLocaleString(locales, options);
        // e. Let R be a String value produced by
        //   concatenating S and R.
        r = s + r;
        // f. Increase k by 1.
        k++;
      }
      // 10. Return R.
      return r;
    }
  });
}
					

If you need to support truly obsolete JavaScript engines that don't support Object.defineProperty , it's best not to polyfill Array.prototype methods at all, as you can't make them non-enumerable.

范例

使用 locales and options

The elements of the array are converted to strings using their toLocaleString 方法。

• Object : Object.prototype.toLocaleString()
• Number : Number.prototype.toLocaleString()
• Date : Date.prototype.toLocaleString()

Always display the currency for the strings and numbers in the prices array:

var prices = ['￥7', 500, 8123, 12];
prices.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' });
// "￥7,￥500,￥8,123,￥12"
					

For more examples, see also the Intl , NumberFormat ，和 DateTimeFormat pages.

规范

规范
ECMAScript (ECMA-262) The definition of 'Array.prototype.toLocaleString' in that specification.
ECMAScript 国际化 API (ECMA-402) The definition of 'Array.prototype.toLocaleString' in that specification.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
toLocaleString	Chrome 1	Edge 12	Firefox 1	IE 5.5	Opera 4	Safari 1	WebView Android ≤37	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0	nodejs 0.1.100
可选 locales parameter	Chrome 24	Edge 79	Firefox 52	IE No	Opera 15	Safari 6.1	WebView Android ≤37	Chrome Android 25	Firefox Android No	Opera Android 14	Safari iOS 6.1	Samsung Internet Android 2.0	nodejs 13.0.0 13.0.0 部分支持 0.12 Before version 13.0.0, only the locale data for en-US is available by default. When other locales are specified, the function silently falls back to en-US . To make full ICU (locale) data available for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.
可选 options parameter	Chrome 24	Edge 79	Firefox 52	IE No	Opera 15	Safari 6.1	WebView Android ≤37	Chrome Android 25	Firefox Android No	Opera Android 14	Safari iOS 6.1	Samsung Internet Android 2.0	nodejs 0.12

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

另请参阅

• Array.prototype.toString()
• Intl
• Object.prototype.toLocaleString()
• Number.prototype.toLocaleString()
• Date.prototype.toLocaleString()

元数据

• 最后修改： May 20, 2020

相关话题

1. 标准内置对象
2. Array
3. 特性
   1. Array.prototype.length
   2. Array.prototype[@@unscopables]
4. 方法
   1. Array.from()
   2. Array.isArray()
   3. Array.of()
   4. Array.prototype.concat()
   5. Array.prototype.copyWithin()
   6. Array.prototype.entries()
   7. Array.prototype.every()
   8. Array.prototype.fill()
   9. Array.prototype.filter()
   10. Array.prototype.find()
   11. Array.prototype.findIndex()
   12. Array.prototype.flat()
   13. Array.prototype.flatMap()
   14. Array.prototype.forEach()
   15. Array.prototype.includes()
   16. Array.prototype.indexOf()
   17. Array.prototype.join()
   18. Array.prototype.keys()
   19. Array.prototype.lastIndexOf()
   20. Array.prototype.map()
   21. Array.prototype.pop()
   22. Array.prototype.push()
   23. Array.prototype.reduce()
   24. Array.prototype.reduceRight()
   25. Array.prototype.reverse()
   26. Array.prototype.shift()
   27. Array.prototype.slice()
   28. Array.prototype.some()
   29. Array.prototype.sort()
   30. Array.prototype.splice()
   31. Array.prototype.toLocaleString()
   32. Array.prototype.toSource()
   33. Array.prototype.toString()
   34. Array.prototype.unshift()
   35. Array.prototype.values()
   36. Array.prototype[@@iterator]()
   37. get Array[@@species]
5. 继承：
6. Function
7. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
8. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()
9. Object
10. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
11. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()