toLocaleString()
メソッドは、配列の要素を表す文字列を返します。配列の要素は、それぞれの toLocaleString
メソッドを使い、ロケール固有の文字列に変換されます(例えばカンマ “,”などはロケールによっては “.”で表されます)。
構文
arr.toLocaleString([locales[, options]]);
引数
locales
Optional- BCP 47 言語タグの文字列か、その配列です。
locales
引数の一般的な形式と解釈についてはIntl
ページを参照してください。 options
Optional- 設定プロパティのオブジェクトです。数値に関しては
Number.prototype.toLocaleString()
を、日付に関してはDate.prototype.toLocaleString()
を見てください。
戻り値
配列の要素を表す文字列です。
説明
locales
と options
を使う
配列の要素は、その toLocaleString
メソッドを使用して文字列に変換されます。
Object
:Object.prototype.toLocaleString()
Number
:Number.prototype.toLocaleString()
Date
:Date.prototype.toLocaleString()
prices
配列内の文字列と数値の通貨を常に表示します。
var prices = ['¥7', 500, 8123, 12]; prices.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }); // "¥7,¥500,¥8,123,¥12"
さらに多くの例を知りたいなら、 Intl
や NumberFormat
、DateTimeFormat
ページを見てください。
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; } }); }
Object.defineProperty
が利用できないとても古い JavaScript エンジンをサポートする必要がある場合、Array.prototype
のメソッドを polyfill するのは避けたほうがよいでしょう。それらを列挙不可にすることができないからです。
仕様
仕様 | 状況 | コメント |
---|---|---|
ECMAScript Latest Draft (ECMA-262) Array.prototype.toLocaleString の定義 |
ドラフト | ECMAScript 3 で初めて定義されました。 |
ECMAScript Internationalization API 4.0 (ECMA-402) Array.prototype.toLocaleString の定義 |
ドラフト | この定義は ECMA-262 の定義より優先されます。 |
ブラウザー実装状況
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.
Update compatibility data on GitHub
デスクトップ | モバイル | サーバー | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toLocaleString | Chrome 完全対応 1 | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 5.5 | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 ≤37 | Chrome Android 完全対応 18 | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 1.0 | nodejs 完全対応 あり |
Optional locales parameter | Chrome 完全対応 24 | Edge 未対応 なし | Firefox 完全対応 52 | IE 未対応 なし | Opera 完全対応 15 | Safari 完全対応 6.1 | WebView Android 完全対応 ≤37 | Chrome Android 完全対応 25 | Firefox Android 未対応 なし | Opera Android 完全対応 14 | Safari iOS 完全対応 6.1 | Samsung Internet Android 完全対応 2.0 | nodejs ? |
Optional options parameter | Chrome 完全対応 24 | Edge 未対応 なし | Firefox 完全対応 52 | IE 未対応 なし | Opera 完全対応 15 | Safari 完全対応 6.1 | WebView Android 完全対応 ≤37 | Chrome Android 完全対応 25 | Firefox Android 未対応 なし | Opera Android 完全対応 14 | Safari iOS 完全対応 6.1 | Samsung Internet Android 完全対応 2.0 | nodejs ? |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明