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

Temporal.ZonedDateTime.prototype.toPlainDate()メソッドは、タイムゾーン情報と時刻情報を持つTemporal.ZonedDateTimeオブジェクトから、日付の部分のみを抽出し、タイムゾーン情報や時刻情報を含まないTemporal.PlainDateオブジェクトとして取得するメソッドです。JavaScriptのTemporal APIにおいて、ZonedDateTimeは特定の日付、時刻、およびタイムゾーン（例えば、日本標準時やニューヨーク時間など）のオフセット情報がすべて含まれた、最も包括的な日時を表します。このメソッドを使用することで、その包括的な情報の中から、純粋な「年、月、日」の要素だけを取り出すことが可能となります。

例えば、ある特定のタイムゾーンにおけるイベントの正確な開始日時がZonedDateTimeで表されている場合でも、そのイベントが「何月何日」の出来事であるかという日付情報のみが必要な場面があります。toPlainDate()メソッドは、このような場合にタイムゾーンや時刻の複雑な情報を意識することなく、シンプルに日付として扱いたいというニーズに応えます。結果として返されるPlainDateオブジェクトは、年、月、日のみを保持し、タイムゾーンや時間帯のオフセット、さらには時、分、秒といった時刻情報は一切含まれません。これにより、日付に関する処理をより直感的かつ安全に行うことが可能となり、システムエンジニアが日付操作を扱う際のロジックの簡素化に貢献します。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:00:00[Asia/Tokyo]');
2const plainDate = zonedDateTime.toPlainDate();

引数なし

引数はありません

Temporal.PlainDate

Temporal.ZonedDateTime.prototype.toPlainDate()は、呼び出し元のTemporal.ZonedDateTimeオブジェクトの年月日時分秒ミリ秒マイクロ秒ナノ秒の情報を元に、タイムゾーン情報やオフセット情報を含まないTemporal.PlainDateオブジェクトを返します。