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

toLocaleStringメソッドは、Dateオブジェクトが保持する日付と時刻の情報を、特定のロケール（地域や言語）に合わせた形式の文字列に変換して返すメソッドです。

このメソッドは、引数としてlocalesとoptionsの二つを受け取ります。locales引数には、言語タグを示す文字列、またはそれらの配列を指定します。例えば、'ja-JP'を指定すれば日本の形式で、'en-US'を指定すればアメリカ合衆国の形式で日時が整形されます。この引数を省略した場合、Node.jsが動作している環境のデフォルトロケールが適用されます。

options引数には、日付や時刻の表示形式を詳細に設定するためのプロパティを持つオブジェクトを渡します。例えば、年の表示を4桁にするか2桁にするか、月の表示を数値にするか長い名称にするか、時刻に秒を含めるか含めないか、といった指定が可能です。また、表示するタイムゾーンを指定することもできます。

toLocaleStringメソッドは、これらの指定に基づいて整形された日付と時刻の文字列を返します。この機能は、国際化対応されたアプリケーションにおいて、利用者が自身の文化圏で慣れ親しんだ形式で日付時刻情報を正確に把握できるようにするために不可欠です。

Copy
1const date = new Date();
2const formattedDate = date.toLocaleString();
3console.log(formattedDate);

locales = undefined, options = undefined

• locales: string | string[] | undefined: 出力で使用するロケール（言語や地域）を指定します。省略した場合、実行環境のデフォルトロケールが使用されます。
• options: Intl.DateTimeFormatOptions | undefined: 日付と時刻のフォーマット方法を詳細に指定するオプションオブジェクトです。

string

指定されたロケール（地域設定）とオプションに基づいて、日付と時刻を文字列として返します。