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

Temporal.Instant.prototype.toZonedDateTimeISO()メソッドは、特定の瞬間を表すTemporal.Instantオブジェクトを、指定されたタイムゾーンとISO 8601カレンダーに基づいて、より具体的な日時情報を持つTemporal.ZonedDateTimeオブジェクトに変換するメソッドです。

Temporal.Instantは、タイムゾーンやカレンダーに依存しない、単一の「時間的な瞬間」を協定世界時（UTC）からの経過時間として表現します。これは、全世界共通で「いつ」という一点を指し示す情報です。一方、Temporal.ZonedDateTimeは、その「いつ」という瞬間に加えて、「どこで（どのタイムゾーンで）」そして「どのように（ISO 8601カレンダーで）」その時間を解釈するかという詳細な情報を持つため、人間にとって具体的な日付と時刻として理解しやすい形式になります。

このメソッドを利用することで、例えば、タイムゾーン情報を持たないデータベース上の時刻（Instant）を、ユーザーの現在地や希望するタイムゾーン（例：'Asia/Tokyo'）に合わせたローカルな日付と時刻（ZonedDateTime）に変換することが可能です。変換時には、引数としてターゲットとなるタイムゾーンを指定する必要があります。これにより、グローバルな時間情報を特定の地域やカレンダーに合わせて適切に解釈し、表示するための強力な手段を提供します。このメソッドは、国際的なアプリケーション開発において、時間処理の正確性と柔軟性を高めるために非常に重要です。

Copy
1const instant = Temporal.Instant.from('2023-10-27T10:00:00Z');
2const zonedDateTime = instant.toZonedDateTimeISO('America/New_York');

timeZone

• timeZone: Intl.DateTimeFormat.prototype.resolvedOptions().timeZone で取得できるような、タイムゾーンを表す文字列。例えば "UTC" や "Asia/Tokyo" など。

Temporal.ZonedDateTime

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