【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTimeコンストラクタの使い方

Temporal.ZonedDateTime()メソッドは、特定のタイムゾーンにおける日付と時刻の情報を保持するTemporal.ZonedDateTimeオブジェクトを生成するために使用されるメソッドです。このメソッドを通じて生成されるZonedDateTimeオブジェクトは、日付（年、月、日）、時刻（時、分、秒など）、そしてオフセットやタイムゾーンの識別子といった情報を一つのまとまりとして表現します。

一般的な日付や時刻のオブジェクトでは、特定の地点での時間情報が欠けていることがありますが、ZonedDateTimeはタイムゾーン情報を持つことで、世界中のどこであっても正確な時間を扱うことが可能になります。これは、例えばサマータイム（夏時間）の導入や廃止といったタイムゾーン固有の複雑なルールを考慮し、常に正しい時間表現を提供することを意味します。

システム開発においては、国際的なサービスや、複数の地域にまたがるユーザーを持つアプリケーション、あるいは異なるタイムゾーンに配置されたサーバー間で時間を同期する必要がある場面で非常に重要です。例えば、イベントの開催時刻を世界中のユーザーに適切に表示したり、ログのタイムスタンプを正確に管理したりする際に、ZonedDateTimeはデータの整合性を保つ上で役立ちます。

通常、このコンストラクタメソッドを直接new演算子で呼び出すことは推奨されず、Temporal.ZonedDateTime.from()のようなファクトリメソッドや、既存のTemporalオブジェクトの変換メソッドを通じてZonedDateTimeインスタンスが生成されることがほとんどです。これにより、より安全かつ簡単に、意図するタイムゾーンの時刻オブジェクトを扱うことができます。

Copy
1new Temporal.ZonedDateTime(
2  temporalDateTimeOrInstantOrString, // Temporal.PlainDateTime, Temporal.Instant, or ISO 8601 string
3  temporalTimeZoneOrString,          // Temporal.TimeZone or IANA time zone identifier string
4  optionsObject                      // Optional: object with configuration properties (e.g., calendar, offset)
5);

epochNanoseconds, timeZone, calendar

• epochNanoseconds: Temporal.Instant.fromEpochNanoseconds() または Temporal.PlainDateTime.from() から取得された、エポック（1970年1月1日 UTC）からの経過時間（ナノ秒単位）を表す値
• timeZone: タイムゾーンを表す Temporal.TimeZone オブジェクト
• calendar: カレンダーを表す Temporal.Calendar オブジェクト

戻り値なし

戻り値はありません