JavaScript

Object.prototype.toLocaleString()メソッド

 編集:2022.08.20 by T.A.

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

obj.toLocaleString([locales[, options]]
obj Object
locales Array.prototype.toLocaleString()
options Array.prototype.toLocaleString()
戻り値

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

解説

Object の toLocaleString は toString() を呼び出した結果を返します。

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

toLocaleString を上書きしているオブジェクト
Array における toLocaleString() の上書き

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

例を示します:

const testArray = [4, 7, 10];

D=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)"

D=testDate.toLocaleString('de');	//="29.5.2020, 18:04:24"
D=testDate.toLocaleString('fr');	//="29/05/2020 à 18:04:24"
Number における toLocaleString() の上書き

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

例を示します:

const testNumber = 2901234564;	//=2901234564
D=testNumber.toLocaleString('de');	//="2.901.234.564"
D=testNumber.toLocaleString('fr');	//="2 901 234 564"

テスト