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

Temporal.Instant.prototype.since()メソッドは、ある特定の時点から別の特定の時点までの期間を計算するメソッドです。JavaScriptのTemporal APIの一部として提供されており、Temporal.Instantオブジェクトが表す、タイムゾーンに依存しない絶対的な時点間の差を、Temporal.Durationオブジェクトとして正確に測定します。

このメソッドを使用すると、呼び出し元のTemporal.Instantインスタンスから、引数として指定された別のTemporal.Instantインスタンスまでの経過期間を求めることができます。引数には、期間計算の基準となるTemporal.Instantオブジェクトを渡します。また、オプションとして、期間を計算する際の丸め単位（例えば、年、月、日、時間など）や、期間の表現に使用する最大の単位、最小の単位などを指定するためのプレインオブジェクトも受け取ることが可能です。

戻り値はTemporal.Durationオブジェクトであり、これは年、月、日、時、分、秒、ミリ秒、マイクロ秒、ナノ秒といった単位で、二つの時点間の時間の長さを示します。例えば、あるイベントが発生した瞬間と現在の瞬間との正確な時間差を求めたい場合や、システムが記録した二つのタイムスタンプ間の処理時間を測定したい場合に、このsince()メソッドは非常に有用です。

従来のDateオブジェクトを用いた日付計算では、タイムゾーンの扱いやうるう秒などの考慮が複雑になることがありましたが、Temporal.Instant.prototype.since()はこれらの課題を克服し、開発者がより直感的かつ正確に期間を扱えるように設計されています。システムエンジニアを目指す初心者の方々にとっても、日付や時刻の差分計算を堅牢に行うための重要なツールとなるでしょう。

Copy
1const instantA = Temporal.Instant.from('2023-01-01T00:00:00Z');
2const instantB = Temporal.Instant.from('2023-01-02T00:00:00Z');
3const duration = instantA.since(instantB);

other, options = {}

• other: Temporal.Instant: 比較対象となる別のTemporal.Instantインスタンス
• options: object = {}: オプションを指定するオブジェクト（省略可能）

Temporal.Duration

このメソッドは、二つのTemporal.Instantオブジェクト間の時間差を表すTemporal.Durationオブジェクトを返します。