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

Temporal.PlainDateTime.prototype.toZonedDateTime()メソッドは、タイムゾーン情報を持たない日付と時刻を表すTemporal.PlainDateTimeオブジェクトに、指定されたタイムゾーン情報を付与して、特定のタイムゾーンにおける日付と時刻を表すTemporal.ZonedDateTimeオブジェクトに変換するメソッドです。

このメソッドを使用することで、タイムゾーンが未指定の状態の日付と時刻情報に対し、特定の地域における時間帯（例えば「アジア/東京」や「アメリカ/ニューヨーク」など）の概念を関連付けることができます。引数としてタイムゾーンの識別子（文字列）やTemporal.TimeZoneオブジェクトを渡すことで、PlainDateTimeオブジェクトがそのタイムゾーンにおける具体的な時間として解釈され、ZonedDateTimeオブジェクトが生成されます。また、夏時間（DST）の開始や終了といったタイムゾーンのルール変更によって時刻が重複したりスキップされたりする場合に、その曖昧な状況をどのように解決するかを指定するオプションも利用可能です。

この変換は、例えば、データベースにタイムゾーン情報なしで保存されているイベントの日時データを、アプリケーションの利用者が選択したタイムゾーンに合わせて正確に表示したい場合などに非常に役立ちます。タイムゾーンの違いによる時刻のずれを適切に処理し、国際的なアプリケーションにおける日付と時刻の管理を容易にするための重要な機能を提供します。これにより、開発者は複雑なタイムゾーン計算を手動で行うことなく、信頼性の高い時間処理を実装できます。

Copy
1const plainDateTime = Temporal.PlainDateTime.from('2023-10-27T10:00:00');
2const zonedDateTime = plainDateTime.toZonedDateTime('America/New_York');

timeZone, options = {}

• timeZone: TimeZoneオブジェクト: 変換先のタイムゾーンを指定します。
• options = {}: PlainDateTimeToStringOptionsオブジェクト: 変換時のオプションを指定します。省略可能です。

Temporal.ZonedDateTime

このメソッドは、指定されたタイムゾーン情報を持つTemporal.ZonedDateTimeオブジェクトを返します。