【JavaScript ECMAScript】Temporal::Temporal.PlainDate.prototype.addインスタンスメソッドの使い方
Temporal.PlainDate.prototype.add()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainDate.prototype.add()メソッドは、日付のみを扱うTemporal.PlainDateインスタンスに対して、指定された期間を加算し、その結果として新しいTemporal.PlainDateインスタンスを生成するメソッドです。このメソッドは、元のPlainDateインスタンスを直接変更するのではなく、加算後の日付を持つ全く新しいインスタンスを返します。これにより、元のオブジェクトのデータが意図せず変更されることを防ぎ、予測可能なコードの記述を支援します。
加算する期間は、年、月、日、週といった時間単位をプロパティとして持つオブジェクト、またはTemporal.Durationオブジェクトとして指定できます。例えば、特定の日付から5日後や3ヶ月後、あるいは数年後の日付を正確に計算したい場合に、このadd()メソッドを使用します。この機能は、スケジュール管理システムやイベントの期日計算、データの有効期限チェックなど、日付に関連する様々なプログラミングタスクにおいて非常に有用です。正確な日付計算をシンプルに行うための、Temporal APIの中核的な機能の一つと言えます。
公式リファレンス: Temporal.PlainDate.prototype.add()
構文(syntax)
1plainDate.add(durationLike);
引数(parameters)
durationLike
- durationLike: 加算する期間を表すオブジェクト。Temporal.Durationオブジェクト、または日付の年、月、日、週に対応するプロパティを持つオブジェクトを指定できます。
戻り値(return)
Temporal.PlainDate
このメソッドは、指定された期間を加算した新しい Temporal.PlainDate オブジェクトを返します。元の Temporal.PlainDate オブジェクトは変更されません。