【JavaScript ECMAScript】Temporal::Temporal.PlainDateTime.prototype.toPlainDateインスタンスメソッドの使い方

Temporal.PlainDateTime.prototype.toPlainDate()メソッドは、Temporal.PlainDateTimeオブジェクトが保持する日付と時刻の情報から、日付部分のみを抽出し、新しいTemporal.PlainDateオブジェクトとして生成して返すメソッドです。Temporal.PlainDateTimeは、特定のタイムゾーン情報を含まない、カレンダー日付（年、月、日）と時刻（時、分、秒など）の組み合わせを表すオブジェクトです。例えば、「2024年7月26日 10時30分00秒」といった具体的な日時を表しますが、これがどのタイムゾーンでの日時であるかという情報は持ちません。

このtoPlainDate()メソッドは引数を取りません。メソッドを呼び出すと、元のPlainDateTimeオブジェクトから年、月、日の情報が取得され、その情報をもとに新しいTemporal.PlainDateオブジェクトが作成されます。Temporal.PlainDateオブジェクトもまた、タイムゾーン情報を含まず、カレンダー日付（年、月、日）のみを表すオブジェクトです。例えば、「2024年7月26日」のように日付そのものを扱いたい場合に利用されます。

このメソッドの主な用途は、日時情報から時刻の要素を切り捨て、日付そのものだけを扱いたい場合にあります。例えば、ユーザーの誕生日やイベントの日付など、時刻情報が不要で、日付の比較や表示、カレンダー表示といった場面で非常に便利です。JavaScriptの新しいTemporal APIの一部として、より堅牢で直感的な日付と時刻の操作を実現するために提供されています。

Copy
1const plainDateTime = new Temporal.PlainDateTime(2023, 10, 27, 10, 30, 0);
2const plainDate = plainDateTime.toPlainDate();

引数なし

引数はありません

Temporal.PlainDate

このメソッドは、呼び出し元の Temporal.PlainDateTime オブジェクトから時間情報（時、分、秒、ミリ秒など）を取り除き、日付情報のみを持つ新しい Temporal.PlainDate オブジェクトを生成して返します。