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

Temporal.PlainTime.prototype.add()メソッドは、日付やタイムゾーン情報を含まない純粋な時刻を表すTemporal.PlainTimeインスタンスに対して、指定された時間量を加算し、その結果として新しいTemporal.PlainTimeオブジェクトを生成して返すメソッドです。

Temporal.PlainTimeオブジェクトは、午前10時30分といった時刻のみを扱い、年や月日、タイムゾーンの情報は持ちません。このadd()メソッドは、この時刻情報に対し、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒といった時間的な長さを表す「期間（Duration）」を加えることができます。

add()メソッドに渡す時間量は、Temporal.Durationオブジェクトであるか、あるいは時間量を表すプロパティ（例: hours: 2, minutes: 30）を持つプレーンなJavaScriptオブジェクトとして指定します。

このメソッドの重要な特徴は、元のTemporal.PlainTimeオブジェクトを直接変更しない「イミュータブル」な操作である点です。加算の結果は常に新しいTemporal.PlainTimeオブジェクトとして返されるため、元の時刻データを安全に保持したまま、さまざまな時刻計算を行うことができます。

例えば、ある時刻から特定の時間後や時間前の時刻を求めたい場合など、日付やタイムゾーンの影響を受けずに時刻部分のみを正確に操作する際に非常に有用です。ECMAScriptのTemporal APIにおける、堅牢な日付と時刻の管理を支援する機能の一つとして提供されています。

Copy
1const plainTimeInstance = Temporal.PlainTime.from('09:00:00');
2const resultTime = plainTimeInstance.add({ hours: 2, minutes: 15 });

durationLike

• durationLike: 時間の加算量を表すオブジェクト（Temporal.Duration, Temporal.DurationLike）

Temporal.PlainTime

指定された時間（Temporal.PlainTime）に、指定された期間（Temporal.Duration）を加算した新しいTemporal.PlainTimeオブジェクトを返します。