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

Temporal.Duration.prototype.secondsプロパティは、JavaScriptのTemporal APIにおいて、時間量を表すTemporal.Durationオブジェクトが保持する「秒」の成分の値を参照するためのプロパティです。

Temporal.Durationオブジェクトは、年、月、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒といった様々な時間単位を組み合わせて特定の一連の時間量を表現します。このsecondsプロパティは、そのDurationインスタンスに設定されている秒単位の値を数値として提供します。例えば、1時間と30秒という時間量を表すDurationオブジェクトがある場合、このsecondsプロパティにアクセスすると30という数値を取得できます。

このプロパティは読み取り専用のアクセサープロパティであり、直接値を設定することはできません。Durationインスタンスが生成された際や、他のDurationインスタンスから計算によって派生した際に設定された秒の値を取得するために使用されます。Durationオブジェクトが持つ時間量を分析したり、その中で特に秒の成分がいくつであるかを知りたい場合に役立ちます。秒の値は、正または負の整数、あるいは浮動小数点数となり得ます。他の時間単位も同様に、それぞれのプロパティ（例: minutes, hours, days）を通じて参照することが可能です。これにより、時間に関する複雑な計算や表示処理を行う際に、各時間単位の値を容易に取り扱うことができます。

Copy
1const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 45, milliseconds: 500 });
2const secondsComponent = duration.seconds;
3console.log(secondsComponent);

引数なし

引数はありません

Number

Temporal.Duration.prototype.seconds は、Temporal.Duration オブジェクトが表す期間の秒数を示す数値（Number）を返します。