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

Temporal.PlainTime.prototype.subtract()メソッドは、Temporal.PlainTimeオブジェクトが表す日付やタイムゾーン情報を含まない純粋な時刻から、指定された時間量を減算し、新しいTemporal.PlainTimeオブジェクトを返すメソッドです。このメソッドは、例えば「現在の時刻から特定の時間、分、秒を差し引いた時刻」を計算したい場合に使用されます。

Temporal.PlainTimeオブジェクトは、午前9時30分00秒といった具体的な時刻情報のみを保持しており、日付やタイムゾーンによる影響を受けません。subtract()メソッドの引数には、減算したい期間を定義するオブジェクトを指定します。この期間は、時間（hour）、分（minute）、秒（second）、ミリ秒（millisecond）、マイクロ秒（microsecond）、ナノ秒（nanosecond）などの単位で指定でき、Temporal.Durationオブジェクトや、その形式に変換可能なプレーンなJavaScriptオブジェクトとして渡すことが可能です。

このメソッドの重要な特徴として、呼び出し元のTemporal.PlainTimeオブジェクト自体は変更されず、減算結果として新しいTemporal.PlainTimeオブジェクトが生成される点が挙げられます。これにより、意図しないデータの変更を防ぎ、予測可能なプログラムの動作を保証します。システムエンジニアを目指す上で、日付や時刻の厳密な計算は頻繁に発生するため、このsubtract()メソッドはTemporal APIを利用した時刻操作において基本的ながらも非常に重要な機能となります。

Copy
1const initialPlainTime = new Temporal.PlainTime(10, 0);
2const resultPlainTime = initialPlainTime.subtract({ hours: 1, minutes: 30 });

duration

• duration: Temporal.Duration:Subtractする期間を指定します。

Temporal.PlainTime

このメソッドは、指定された時間間隔を現在の時刻から減算した結果として、新しいTemporal.PlainTimeオブジェクトを返します。