【JavaScript ECMAScript】Temporal::Temporal.Duration.prototype.hoursインスタンスアクセサプロパティの使い方

Temporal.Duration.prototype.hoursプロパティは、JavaScriptのTemporal APIにおけるTemporal.Durationオブジェクトのインスタンスから、その期間の「時間」成分を数値として取得するために使用される読み取り専用のプロパティです。このプロパティは、ECMAScriptの新しい日付・時刻APIであるTemporalの一部として提供されており、時間の長さや経過時間を正確かつ直感的に表現・操作することを目的としています。

Temporal.Durationオブジェクトは、年、月、日、時間、分、秒といった様々な時間単位の成分を保持することができます。その中でもhoursプロパティは、Temporal.Durationインスタンスが表現する期間のうち、時間に相当する成分の値だけを取り出す役割を担います。例えば、Temporal.Duration.from({ hours: 5, minutes: 30 })という期間オブジェクトの場合、そのhoursプロパティを参照すると「5」という数値が返されます。

このプロパティはアクセサープロパティであるため、値の設定はできませんが、期間の正確な時間成分を簡単に取得できるため、時間計算や時間表示の際に非常に便利です。特に、時間計算を伴うシステム開発において、従来のDateオブジェクトでは難しかった期間の明確な表現と成分ごとのアクセスを可能にし、より堅牢なコードの記述に貢献します。時間成分が明示的に設定されていないDurationオブジェクトでは、hoursプロパティは0を返します。システムエンジニアを目指す方にとって、時間管理を伴うアプリケーション開発で不可欠なツールとなるでしょう。

Copy
1const duration = Temporal.Duration.from({ hours: 5, minutes: 30, seconds: 45 });
2const hoursComponent = duration.hours;

引数なし

引数はありません

number

このプロパティは、Temporal.Durationオブジェクトが表す期間の「時間」の値を数値で返します。