このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Object.prototype.toLocaleString()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
toLocaleString() はObject インスタンスのメソッドで、オブジェクトを表す文字列を返します。このメソッドは、ロケール固有の目的のために派生オブジェクトによってオーバーライドするためのものです。
試してみましょう
const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));console.log(date.toLocaleString("ar-EG"));// 予想される結果: "٢٠/١٢/٢٠١٢ ٤:٠٠:٠٠ ص"const number = 123456.789;console.log(number.toLocaleString("de-DE"));// 予想される結果: "123.456,789"構文
toLocaleString()引数
なし。ただし、このメソッドをオーバーライドするすべてのオブジェクトは、Number.prototype.toLocaleString のようにlocales とoptions に対応する最大 2 つの引数を受け取ることが期待されます。これらの引数の位置は、他の目的には使用しないでください。
返値
this.toString() 呼び出しの返値です。
解説
Object.prototype 継承するすべてのオブジェクト（つまり、null プロトタイプオブジェクトを除くすべてのオブジェクト）は、toLocaleString() メソッドを継承します。Object'stoLocaleString は、this.toString() を呼び出した結果を返します。
この関数は、オブジェクトに汎用的なtoLocaleString メソッドを提供するために用意されています。コア言語では、これらの組み込みオブジェクトはtoLocaleString をオーバーライドしてロケール特有の書式設定を行います。
例
基底の toLocaleString() メソッドの使用
基底のtoLocaleString() メソッドは、単純にtoString() を呼び出します。
const obj = { toString() { return "My Object"; },};console.log(obj.toLocaleString()); // "My Object"Array における toLocaleString() のオーバーライド
Array.prototype.toLocaleString()は、各要素のtoLocaleString() メソッドを呼び出して、結果をロケール特有の区切り文字で連結することで、配列の値を文字列として出力するために使用されます。例を示します。
const testArray = [4, 7, 10];const euroPrices = testArray.toLocaleString("fr", { style: "currency", currency: "EUR",});// "4,00 €,7,00 €,10,00 €"Date における toLocaleString() の上書き
Date.prototype.toLocaleString() は、特定のロケールに適した日付表示を出力するために使用されます。例を示します。
const testDate = new Date();// "Date Fri May 29 2020 18:04:24 GMT+0100 （イギリス夏時間）"const deDate = testDate.toLocaleString("de");// "29.5.2020, 18:04:24"const frDate = testDate.toLocaleString("fr");// "29/05/2020, 18:04:24"Number における toLocaleString() の上書き
Number.prototype.toLocaleString() は、特定のロケールに適した数値表示を出力するために使用されます。例を示します。
const testNumber = 2901234564;// "2901234564"const deNumber = testNumber.toLocaleString("de");// "2.901.234.564"const frNumber = testNumber.toLocaleString("fr");// "2 901 234 564"仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.prototype.tolocalestring |