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

toLocaleDateStringメソッドは、Dateオブジェクトの日付部分を、指定されたロケール（言語と地域）の慣習に従った形式で文字列に変換して返却するメソッドです。

このメソッドは、new Date()などで作成されたDateインスタンスに対して呼び出されます。日付の表示形式は、閲覧者やユーザーの居住地域や言語によって異なるため、国際化対応（i18n）が必要なアプリケーション開発において非常に重要です。

第一引数localesには、日付のフォーマットに使用するロケールを指定します。これは、'ja-JP'（日本語・日本）や'en-US'（英語・米国）のような言語タグの文字列、またはそれらの文字列の配列として渡します。この引数を省略した場合、実行環境のデフォルトロケールが使用されます。これにより、環境に応じた最も適切な日付形式が自動的に選択されます。

第二引数optionsには、日付の表示スタイルをさらに細かく制御するためのプロパティを持つオブジェクトを指定します。例えば、year（年）、month（月）、day（日）の表示を数値（numeric）にするか二桁（2-digit）にするか、または月名を長い形式（long）で表示するかなどを設定できます。また、weekdayプロパティを使って曜日を表示することも可能です。

これらの引数を活用することで、「2024年7月26日」のような特定の書式から、「2024/07/26」のような簡潔な書式まで、ユーザーにとって分かりやすい日付表現を柔軟に生成することができます。

Copy
1const date = new Date();
2const dateString = date.toLocaleDateString('ja-JP', { year: 'numeric', month: '2-digit', day: '2-digit' });
3console.log(dateString);

locales, options

• locales: string | string[] | undefined: ロケールを指定します。地域ごとの日付や時刻の書式設定に使用されます。省略した場合は、実行環境のデフォルトロケールが使用されます。
• options: Intl.DateTimeFormatOptions | undefined: 日付の書式設定に関する詳細なオプションを指定します。年、月、日、曜日、時刻などの表示方法を細かく制御できます。

string

指定されたロケール（地域設定）の書式に従った日付を表す文字列を返します。