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

Temporal.Duration.prototype.add()メソッドは、Temporal.Durationオブジェクトに別の期間を加算し、その結果を新しいTemporal.Durationオブジェクトとして返すメソッドです。これは、JavaScriptの新しいTemporal APIにおいて、複数の時間量を正確に組み合わせる基本的な操作を提供します。

このメソッドは、呼び出し元のTemporal.Durationインスタンスが表す期間に、引数として指定された別の期間を加算します。引数には、加算したい期間を表すTemporal.Durationオブジェクト、または期間の各要素（年、月、日、時間など）を含むプレーンなオブジェクトを指定できます。add()メソッドは、呼び出し元の期間と引数の期間の各時間単位（年、月、日、時間、分、秒など）の値をそれぞれ単純に合計します。

重要な特徴として、この加算処理中に時間単位の正規化（例えば60分を1時間にするような繰り上がり）は自動では行われません。「1時間30分」と「2時間45分」を加算すると、「3時間75分」のように、各時間単位の値がそのまま合計された結果が得られます。また、元のTemporal.Durationオブジェクトは変更されず、加算の結果は常に新しいTemporal.Durationオブジェクトとして生成されます。この設計により、開発者は期間の構成要素を個別に正確に管理し、必要に応じて明示的な正規化を行う柔軟な時間計算が可能となります。

Copy
1const duration1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
2const duration2 = Temporal.Duration.from({ minutes: 45 });
3
4const resultDuration = duration1.add(duration2);

other, options

• other: Temporal.Duration: 加算する別のTemporal.Durationオブジェクト
• options: Temporal.ArithmeticOptions | undefined: 加算時のオプション（例: 繰り上がり処理など）を指定するオブジェクト（省略可能）

Temporal.Duration

このメソッドは、別のTemporal.Durationオブジェクトを現在のDurationオブジェクトに加算した結果を表す新しいTemporal.Durationオブジェクトを返します。