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

Temporal.ZonedDateTime.prototype.toPlainTime()メソッドは、Temporal.ZonedDateTimeオブジェクトからタイムゾーン情報と日付情報を除去し、純粋な時刻部分だけを抽出して新しいTemporal.PlainTimeオブジェクトとして返すメソッドです。

Temporal.ZonedDateTimeは、特定のタイムゾーンにおける日付と時刻の両方を詳細に管理するオブジェクトです。しかし、時には日付やタイムゾーンの複雑な情報を考慮せず、「時、分、秒」といった時刻だけをシンプルに扱いたい場合があります。このtoPlainTime()メソッドは、まさにそのようなニーズに応えるために提供されています。

このメソッドを実行すると、元のTemporal.ZonedDateTimeオブジェクトが持つ年、月、日などの日付情報や、タイムゾーン名、オフセットといったタイムゾーン情報がすべて取り除かれ、時、分、秒、ミリ秒、マイクロ秒、ナノ秒といった時刻の要素のみが抽出されます。そして、これらの時刻要素を保持する新しいTemporal.PlainTimeオブジェクトが生成されて返されます。

例えば、タイムゾーンの違いを意識せずに単に時刻だけを比較したい場合や、特定の日付に依存しない繰り返しのイベント時刻を定義したい場合などに非常に便利です。元のTemporal.ZonedDateTimeオブジェクト自体は変更されず、あくまで時刻部分だけを抜き出した新しいオブジェクトが生成されるため、安全に利用できます。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:30:00[America/Los_Angeles]');
2const plainTime = zonedDateTime.toPlainTime();

引数なし

引数はありません

Temporal.PlainTime

このメソッドは、対象となる Temporal.ZonedDateTime オブジェクトの時間部分のみを抽出した Temporal.PlainTime オブジェクトを返します。この PlainTime オブジェクトは、日付やタイムゾーンの情報を含みません。