Object.prototype.toLocaleString()

toLocaleString() メソッドは、オブジェクトを表す文字列を返します。このメソッドは、ロケール固有の目的のために派生オブジェクトによって上書きするためのものです。

構文

obj.toLocaleString()

返値

オブジェクトを表現する文字列です。

解説

ObjecttoLocaleStringtoString() を呼び出した結果を返します。

この関数は、すべての人が使うわけではありませんが、オブジェクトに汎用的な toLocaleString メソッドを与えるために提供されています。以下のリストを参照してください。

toLocaleString を上書きしているオブジェクト

Array における toLocaleString() の上書き

Array オブジェクトでは、 toLocaleString() を使用して配列の値を文字列として表示したり、オプションでロケール固有の識別子 (通貨記号など) を付加して表示したりすることができます。

例を示します。

const testArray = [4, 7, 10];

let euroPrices = testArray.toLocaleString('fr', { style: 'currency', currency: 'EUR'});
// "4,00 €,7,00 €,10,00 €"

Date における toLocaleString() の上書き

Date オブジェクトでは、 toLocaleString() を使用して、特定のロケールに適した日付表示を出力します。

例を示します。

const testDate = new Date(Date.now());
// "Date Fri May 29 2020 18:04:24 GMT+0100 (British Summer Time)"

let deDate = testDate.toLocaleString('de');
// "29.5.2020, 18:04:24"

var frDate = testDate.toLocaleString('fr');
//"29/05/2020 à 18:04:24"

Number における toLocaleString() の上書き

Number オブジェクトでは、 toLocaleString() を使用して、特定のロケールに適した数値表示、例えば正しい区切り文字を使って出力します。

例を示します。

const testNumber = 2901234564;
// "2901234564"

let deNumber = testNumber.toLocaleString('de');
// "2.901.234.564"

let frNumber = testNumber.toLocaleString('fr');
// "2 901 234 564"

仕様書

仕様書
ECMAScript (ECMA-262)
Object.prototype.toLocaleString の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
toLocaleStringChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 5.5Opera 完全対応 4Safari 完全対応 1WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 あり

凡例

完全対応  
完全対応

関連情報