【JavaScript ECMAScript】Intl::Intl.DateTimeFormat.prototype.formatインスタンスメソッドの使い方

Intl.DateTimeFormat.prototype.format()メソッドは、日付と時刻を特定のロケール（言語と地域）や書式設定オプションに基づいて整形し、人間が読みやすい文字列として返すメソッドです。このメソッドは、JavaScriptの国際化APIであるIntl.DateTimeFormatオブジェクトのインスタンスが提供する機能の一つです。

この機能を使用するには、まずnew Intl.DateTimeFormat()コンストラクタを呼び出してIntl.DateTimeFormatのインスタンスを作成します。この際、第一引数でロケール（例えば'ja-JP'で日本語、'en-US'でアメリカ英語など）を、第二引数で日付や時刻の表示形式（年、月、日、時間などをどのように表示するか）を指定できます。インスタンスが作成された後、そのインスタンスに対してformat()メソッドを呼び出し、整形したいDateオブジェクトなどの日付・時刻の値を引数として渡します。

format()メソッドは、指定されたロケールとオプションに基づき、整形された日付・時刻を表す文字列を返します。例えば、new Intl.DateTimeFormat('ja-JP', { year: 'numeric', month: 'long', day: 'numeric' }).format(new Date('2023-01-01'))と記述すると、「2023年1月1日」のような文字列が得られます。

このメソッドは、ウェブアプリケーションやシステムを国際化する上で非常に重要です。ユーザーの地域設定に合わせて日付や時刻を自動的に表示できるため、開発者が各国ごとの複雑な日付書式ルールを個別に実装する手間を省き、利便性の高いユーザーインターフェースを提供することができます。これにより、世界中のユーザーにとって理解しやすく、親しみやすい表示を実現します。

Copy
1const now = new Date();
2const formatter = new Intl.DateTimeFormat('en-US');
3const formattedDate = formatter.format(now);

date

• date: Date: フォーマットする日付を指定するDateオブジェクト

string

指定されたロケールとオプションに基づいて、日付と時刻を人間が読める形式の文字列に変換して返します。