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

Temporal.PlainDate.prototype.toZonedDateTime()メソッドは、Temporal.PlainDateオブジェクトが保持する年、月、日の日付情報に、時刻とタイムゾーンの情報を付与して、Temporal.ZonedDateTimeオブジェクトを生成するメソッドです。

Temporal.PlainDateは、時間やタイムゾーンの情報を含まない、純粋なカレンダー上の日付のみを表すオブジェクトです。これに対して、Temporal.ZonedDateTimeは、特定のタイムゾーンにおける具体的な日時（年、月、日、時、分、秒、タイムゾーン、UTCからのオフセット）を完全に表現するオブジェクトとなります。

このメソッドを使用すると、例えば「2023年10月26日」といった日付だけが分かっているPlainDateインスタンスに対して、「東京タイムゾーンの午前9時」のような具体的な時刻とタイムゾーンの情報を組み合わせ、完全な日時データであるZonedDateTimeを作成できます。引数には、変換したいタイムゾーンの識別子（例: 'Asia/Tokyo'）を文字列で渡すか、Temporal.PlainTimeオブジェクトを渡して任意の時刻を指定できます。引数を省略した場合、時刻はデフォルトで午前0時（00:00:00）として扱われます。

この変換は、日付のみの情報から、特定の地域の具体的なイベント日時を特定したり、タイムゾーンを考慮した正確な日付と時刻の計算を行う必要がある場合に非常に役立ちます。これにより、異なるタイムゾーンにまたがるシステムでも、日時データを一貫して正確に扱えるようになります。

Copy
1const plainDate = Temporal.PlainDate.from('2023-10-27');
2const zonedDateTime = plainDate.toZonedDateTime('America/New_York');

timeZone, options

• timeZone: Temporal.TimeZoneProtocol: タイムゾーンを指定するオブジェクト
• options: object: オプションを指定するオブジェクト（省略可能）

Temporal.ZonedDateTime

Temporal.PlainDate.prototype.toZonedDateTime() メソッドは、このPlainDateオブジェクトを基にして、指定されたタイムゾーンと時刻情報を持つ新しいTemporal.ZonedDateTimeオブジェクトを返します。