【Node.js24.x】Object::toLocaleString()メソッドの使い方

toLocaleStringメソッドは、Objectクラスに属し、現在のオブジェクトを地域に応じた文字列形式に変換して返却するメソッドです。JavaScriptの全てのオブジェクトの基盤となるObject.prototypeに定義されており、他の多くのデータ型がこのメソッドを継承しています。

デフォルトの実装では、ほとんどの場合、toLocaleStringメソッドはtoStringメソッドが返す値と同一の文字列を返します。しかし、日付（Dateオブジェクト）、数値（Numberオブジェクト）、配列（Arrayオブジェクト）など、特定の組み込みオブジェクトではこのメソッドがオーバーライドされています。これにより、これらのオブジェクトは、実行環境のロケール設定や指定されたロケールに基づいて、その値を地域に合わせた書式で文字列化する機能を提供します。

例えば、DateオブジェクトのtoLocaleStringメソッドは日付や時刻を、NumberオブジェクトのtoLocaleStringメソッドは数値を、それぞれ通貨や日付の表記規則、小数点以下の桁数など、文化圏ごとの慣習に沿った形で表現します。これにより、アプリケーションが国際的なユーザーに対応する際に、日付や数値の表示形式を適切にローカライズすることが可能となり、システムエンジニアが国際化対応（i18n）を行う上で非常に重要な役割を果たします。引数としてロケール識別子や書式設定オプションを指定することで、より詳細な表示制御も行えます。

Copy
1const myObject = {};
2console.log(myObject.toLocaleString());

locales, options

• locales: string | string[] | undefined: 使用するロケール（言語と地域）を指定します。配列で複数指定することも可能です。
• options: Intl.NumberFormatOptions | Intl.DateTimeFormatOptions | Intl.ListFormatOptions | undefined: 数値、日付/時刻、またはリストのフォーマット方法を詳細に制御するためのオプションオブジェクトです。

String

指定されたロケールに基づいた、このオブジェクトの文字列表現を返します。