【JavaScript ECMAScript】Temporal::Temporal.Durationコンストラクタの使い方

Temporal.Duration()クラスは、JavaScriptにおいて時間的な「期間」を正確かつ安全に表現するためのクラスです。このクラスは、日付や時刻の複雑な計算をより直感的に扱うことを目的とした新しいTemporal APIの一部として提供されます。

Temporal.Durationインスタンスは、年、月、週、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒といった各時間単位の量（例えば「2年と3ヶ月」や「5時間15分30秒」）を保持します。これにより、特定の日付や時刻に依存せず、純粋な時間の長さを定義することが可能になります。例えば、「あるイベントが開始から終了までどのくらいの期間であったか」や、「あるタスクに要する見込み時間」などを表現する際に非常に有用です。

このクラスのコンストラクタは、これらの各時間単位の値を引数として受け取り、新しい期間オブジェクトを生成します。生成されたTemporal.Durationオブジェクトは不変（immutable）であり、一度作成されるとその内容が変更されることはありません。この特性により、時間計算における予期せぬ副作用を防ぎ、コードの信頼性と予測可能性を高めます。

システムエンジニアとして日付や時刻、期間を扱う機会は多いため、このTemporal.Durationクラスを理解し活用することで、より堅牢で保守しやすいアプリケーションを開発できるようになります。

Copy
1new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds);

years = 0, months = 0, weeks = 0, days = 0, hours = 0, minutes = 0, seconds = 0, milliseconds = 0, microseconds = 0, nanoseconds = 0

• years: number = 0: 年数を表す数値
• months: number = 0: 月数を表す数値
• weeks: number = 0: 週数を表す数値
• days: number = 0: 日数を表す数値
• hours: number = 0: 時間を表す数値
• minutes: number = 0: 分を表す数値
• seconds: number = 0: 秒を表す数値
• milliseconds: number = 0: ミリ秒を表す数値
• microseconds: number = 0: マイクロ秒を表す数値
• nanoseconds: number = 0: ナノ秒を表す数値

戻り値なし

戻り値はありません