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

Temporal.ZonedDateTime.prototype.toPlainDateTime()メソッドは、Temporal.ZonedDateTimeオブジェクトからタイムゾーン情報とUTCからのオフセット情報を取り除き、日付と時刻のみを表すTemporal.PlainDateTimeオブジェクトを生成するメソッドです。

このメソッドを呼び出すと、元のZonedDateTimeが保持していた年、月、日、時、分、秒、ミリ秒などのカレンダー上の日付と時刻の各要素は、結果のPlainDateTimeオブジェクトにそのまま引き継がれます。しかし、元のZonedDateTimeが持っていたタイムゾーン（例: 'Asia/Tokyo'）や、そのタイムゾーンにおけるUTCからの時刻のずれを示すオフセット情報（例: '+09:00'）は、生成されるPlainDateTimeオブジェクトには含まれません。

結果として得られるTemporal.PlainDateTimeオブジェクトは、特定のタイムゾーンに依存しない、純粋な日付と時刻の表現となります。これは、タイムゾーンの概念を考慮せずに、抽象的な「カレンダー上の日時」として日付や時刻を扱いたい場合に特に有用です。例えば、ユーザーのタイムゾーンに関わらず共通の日付計算を行いたい場合や、タイムゾーン情報が不要なデータの入出力処理を行う際に、このメソッドを利用してZonedDateTimeをPlainDateTimeに変換することができます。

Copy
1const zonedDateTime = new Temporal.ZonedDateTime(0n, "America/Los_Angeles");
2const plainDateTime = zonedDateTime.toPlainDateTime();

引数なし

引数はありません

Temporal.PlainDateTime

このメソッドは、Temporal.ZonedDateTime オブジェクトの持つ年月日時分秒ミリ秒マイクロ秒ナノ秒の情報から、タイムゾーン情報を取り除いた Temporal.PlainDateTime オブジェクトを返します。