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

Temporal.PlainDate.prototype.with()メソッドは、既存のTemporal.PlainDateオブジェクトに基づいて、特定の日付フィールド（年、月、日など）を変更した新しいTemporal.PlainDateオブジェクトを生成するために実行するメソッドです。このメソッドの重要な特徴は、元のPlainDateオブジェクト自体を直接変更せず、常に変更後の値を持つ新しいPlainDateオブジェクトを返す点です。これは「イミュータブル」な操作と呼ばれ、予期せぬデータの変更を防ぎ、日付操作の安全性を高めます。

このメソッドには、変更したい日付の要素をプロパティとして持つオブジェクトを引数として渡します。例えば、現在のPlainDateオブジェクトの年だけを2024年に変更したい場合は{ year: 2024 }を、月と日をそれぞれ1月1日に変更したい場合は{ month: 1, day: 1 }を指定します。このように、特定の日付を基準としながら、その一部分だけを効率的に変更して別の日付オブジェクトを作成したい場合に非常に役立ちます。日付計算や表示において、基準日からの派生日を安全かつ簡潔に扱うための基盤となるメソッドです。

Copy
1const currentDate = Temporal.PlainDate.from('2023-10-26');
2const newDate = currentDate.with({ year: 2024, month: 1, day: 15 });

temporalLike

• temporalLike: TemporalObject, datetime, timezone, or date-time string: 新しいPlainDateインスタンスを作成する元となるTemporalオブジェクト、日付、タイムゾーン、または日付時刻を表す文字列。

Temporal.PlainDate

指定されたプロパティやメソッドを適用した新しい Temporal.PlainDate オブジェクトを返します。