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

Temporal.PlainDateTime.from()メソッドは、タイムゾーン情報を含まない日付と時刻の情報を表現する新しいTemporal.PlainDateTimeオブジェクトを生成するメソッドです。

このメソッドは、様々な形式で提供される日付と時刻のデータから、統一されたTemporal.PlainDateTimeオブジェクトを柔軟に構築するために使用されます。例えば、ISO 8601形式の文字列（例: "2023-10-27T10:30:00"）や、日付と時刻の各要素（年、月、日、時、分、秒など）をプロパティとして持つプレーンなオブジェクトを入力値として受け取ることができます。

システム開発において、タイムゾーンを考慮せずに純粋な日付と時刻のみを扱いたい場合に特に有用です。例えば、カレンダー表示や誕生日などのイベント日時設定のように、地理的な位置に依存しない固定の日時を扱うシナリオで活躍します。

従来のJavaScriptのDateオブジェクトが常に協定世界時（UTC）またはローカルタイムゾーンに基づいて動作するのに対し、Temporal.PlainDateTimeオブジェクトはタイムゾーンの概念を含まないため、タイムゾーン変換による複雑さや意図しない挙動を防ぎ、より直感的で予測可能な日付・時刻処理を実現します。これにより、開発者は正確かつ明確に日付と時刻を扱うことができるようになります。

Copy
1Temporal.PlainDateTime.from("2023-10-27T10:30:00");

item, options

• item: Temporal.PlainDateTimeLike オブジェクト、または string、number、Date オブジェクトなどを指定します。この値から PlainDateTime オブジェクトが生成されます。
• options: Temporal.PlainDateTime.from() の動作を制御するためのオプションを指定するオブジェクトです。省略可能です。

Temporal.PlainDateTime

指定された日時情報から Temporal.PlainDateTime オブジェクトを生成し、返します。