【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.from静的メソッドの使い方

Temporal.ZonedDateTime.from()メソッドは、日付、時刻、そしてタイムゾーンの情報を統合して持つTemporal.ZonedDateTimeオブジェクトを生成するメソッドです。このメソッドは、さまざまな形式の入力から新しいZonedDateTimeインスタンスを正確に構築するために使用されます。

具体的には、ISO 8601形式の日時文字列（例: "2023-10-27T10:00:00+09:00[Asia/Tokyo]"）や、年、月、日、時刻、タイムゾーンなどをプロパティとして持つプレーンなオブジェクト、あるいは他のTemporalオブジェクトなど、多様な入力形式を解析できます。指定された入力に基づいて、その時点がどのタイムゾーンにおいてどのような日時であるかを正確に表現するZonedDateTimeオブジェクトが返されます。タイムゾーン情報が入力に明示的に含まれていない場合、このメソッドはデフォルトのタイムゾーン規則に基づいて推測を行うか、明示的にタイムゾーンを指定するオプションを提供します。

この機能により、異なる地域やシステムから取得した日時データを統一された形式で扱い、タイムゾーンの差異によって発生する可能性のある問題を効果的に回避できます。グローバルなアプリケーション開発において、日付と時刻の正確な管理を容易にするための重要なツールとなります。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from("2023-10-27T10:00:00+09:00[Asia/Tokyo]");

item, options = {}

• item: Temporal.ZonedDateTimeLike: 変換元のタイムゾーン付き日時オブジェクト。Temporal.PlainDateTime, Temporal.ZonedDateTime, Temporal.Instant, Temporal.TimeZone, Temporal.PlainDate, Temporal.PlainTime などのオブジェクト、またはそれらのプロパティを持つオブジェクトを指定できます。
• options = {}: オプションを指定するオブジェクト。省略可能です。hasOwnProperty メソッドや valueOf メソッドを持つオブジェクトを渡すこともできます。

Temporal.ZonedDateTime

与えられたJavaScriptのTemporal.ZonedDateTime.from()メソッドは、指定された時間情報とタイムゾーン情報から、新しいTemporal.ZonedDateTimeオブジェクトを生成して返します。このオブジェクトは、特定の日時とタイムゾーンの組み合わせを表します。