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

Temporal.PlainDate.prototype.toPlainDateTime()メソッドは、日付のみを扱うTemporal.PlainDateオブジェクトを、日付と時刻の両方を扱うTemporal.PlainDateTimeオブジェクトに変換するメソッドです。Temporal APIは、JavaScriptで日付と時刻をより正確かつ直感的に操作するために設計された新しい標準機能の一部です。

PlainDateオブジェクトは、タイムゾーンやUTCオフセットを含まない、カレンダー上の特定の日付（例えば2023年10月27日）を表現します。このtoPlainDateTime()メソッドを呼び出すと、そのPlainDateが持つ日付情報に時刻情報が加わり、新しいPlainDateTimeオブジェクトが生成されます。

時刻情報は、メソッドの引数にTemporal.PlainTimeオブジェクトが指定されていない場合、デフォルトで「00:00:00」（午前0時）が設定されます。例えば、2023年10月27日のPlainDateを変換すると、2023年10月27日00:00:00のPlainDateTimeが生成されます。もし特定の時刻（例えば午後3時半）を設定したい場合は、toPlainDateTime(new Temporal.PlainTime(15, 30))のようにTemporal.PlainTimeインスタンスを引数として渡すことで、その時刻を持つPlainDateTimeオブジェクトを得られます。

生成されるPlainDateTimeオブジェクトもまた、タイムゾーンに依存しない「プレーン」な日付と時刻を表現します。このメソッドは、特定の日付に対して具体的な時刻情報を付与し、一連の日付時刻イベントを表現したい場合などに非常に役立ちます。システム内で、日付情報に後から時刻情報を結合する必要があるシナリオで活用されます。

Copy
1const plainDate = Temporal.PlainDate.from('2023-10-27');
2const plainDateTime = plainDate.toPlainDateTime();

timeLike = new Temporal.PlainTime(0, 0, 0, 0, 0, 0)

• timeLike: Temporal.PlainTime: 時刻を表す Temporal.PlainTime オブジェクト。省略した場合、デフォルトで 00:00:00.000000000 になります。

Temporal.PlainDateTime

Temporal.PlainDate.prototype.toPlainDateTime() メソッドは、この Temporal.PlainDate オブジェクトを基にした Temporal.PlainDateTime オブジェクトを返します。これは、日付情報に時刻情報（デフォルトで午前0時）を追加したものです。