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

Temporal.Duration.prototype.abs()メソッドは、Temporal.Duration オブジェクトの絶対値を計算し、その結果を新しい Temporal.Duration オブジェクトとして返すメソッドです。

JavaScriptのTemporal APIは、日付と時刻の複雑な操作をより簡単かつ正確に行うための新しい機能を提供しており、Durationオブジェクトはその中で期間や時間量を表現します。この期間は、「3日」のように正の値を持つこともあれば、「-5時間」のように負の値を持つこともあります。

abs()メソッドの役割は、Durationオブジェクトに含まれる全ての時間要素（年、月、日、時間、分、秒など）の符号を正に変換することです。これにより、期間の方向性（過去や未来）を考慮せず、その純粋な「長さ」や「大きさ」だけを取り出すことができます。例えば、「-2日と-3時間」という期間に対してabs()を呼び出すと、「2日と3時間」という新しいDurationオブジェクトが生成されます。

この機能は、期間の長さを表示する際に常に正の値で示したい場合や、期間の絶対的な大きさを比較したい場合などに非常に役立ちます。元のTemporal.Durationオブジェクト自体は変更されず、常に新しいDurationオブジェクトが生成されるため、オブジェクトの不変性が保たれ、安全に期間操作を行うことができます。これにより、システム内で期間データを扱う際の信頼性と予測可能性が高まります。

Copy
1const negativeDuration = Temporal.Duration.from({ years: -1, months: -2, days: -3, hours: -4, minutes: -5, seconds: -6 });
2const absoluteDuration = negativeDuration.abs();

引数なし

引数はありません

Temporal.Duration

このメソッドは、元のDurationオブジェクトの絶対値（すべての値が正になるように変換されたもの）を表す新しいTemporal.Durationオブジェクトを返します。