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

Temporal.PlainDateTime.prototype.withPlainTime()メソッドは、既存のTemporal.PlainDateTimeオブジェクトの日付情報を保持したまま、時間情報のみを新しい時間値に置き換えた新しいTemporal.PlainDateTimeオブジェクトを生成するメソッドです。Temporal.PlainDateTimeは、カレンダー日付と壁時計の時刻を組み合わせたオブジェクトで、タイムゾーン情報を持たない点が特徴です。このメソッドを使用することで、特定の日付はそのままに、時刻だけを別の時刻に変更したい場合に非常に便利です。

引数には、変更したい時間情報を表すTemporal.PlainTimeオブジェクト、または時・分・秒などの時間要素をプロパティとして持つオブジェクトを渡すことができます。例えば、日付は今日で時刻を午後3時に設定したい場合などに利用できます。このメソッドは元のTemporal.PlainDateTimeオブジェクトを直接変更することはなく、常に新しいオブジェクトを返します。これは、日付と時刻の操作における不変性を保証する設計であり、予期せぬ副作用を防ぎ、データの整合性を保つのに役立ちます。

システムエンジニアが日付と時刻を扱う際、特定のタイムゾーンに依存せず、純粋なカレンダー日付と時刻を操作する必要がある場面は多々あります。withPlainTime()メソッドは、このような要件に対応するために、既存の日付のコンテキストを維持しつつ、柔軟に時間部分を更新する手段を提供します。これにより、正確で予測可能な日付と時刻の処理を効率的に行うことができます。

Copy
1plainDateTime.withPlainTime(plainTime[, options])

time, options = {}

• time: Temporal.Time: 新しく設定したい時刻を表すTemporal.Timeオブジェクト
• options: object = {}: オプションを指定するオブジェクト（デフォルトは空オブジェクト）

Temporal.PlainDateTime

Temporal.PlainDateTime.prototype.withPlainTime()メソッドは、元のPlainDateTimeオブジェクトの年月日部分を保持し、指定された時間（時、分、秒、ミリ秒、マイクロ秒、ナノ秒）で構成される新しいPlainDateTimeオブジェクトを返します。