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

Temporal.Duration.prototype.signプロパティは、Temporal.Durationオブジェクトが表す期間の符号を数値で示すアクセサープロパティです。このプロパティは、Temporal.Durationオブジェクトが保持する期間が負の値（例えば、過去への時間差）であれば-1を返します。期間がゼロ（時間の長さが全くない状態）であれば0を返し、期間が正の値（例えば、未来への時間差）であれば1を返します。

Temporal.Durationは、年、月、日、時間、分、秒などの単位で時間の長さを厳密かつ不変に表現するためのJavaScriptの新しい組み込みオブジェクトです。このsignプロパティを利用することで、Durationオブジェクトが表す期間の「方向性」を簡単に判別できます。これにより、時間計算の結果が未来への期間なのか、過去への期間なのか、あるいはちょうどゼロの期間なのかを、数値で直接的に判断することが可能です。

システム開発において、イベントの残り時間や経過時間など、時間に関する複雑なロジックを実装する際に、このsignプロパティは非常に役立ちます。例えば、特定の期間がすでに過ぎ去ったのか、これから到来するのかを条件分岐で判断する際に、期間を構成する各要素（年、月、日など）を個別に比較する手間を省き、コードの可読性と簡潔性を向上させることができます。

Copy
1const durationInstance = Temporal.Duration.from({ hours: -1, minutes: 30 });
2const signValue = durationInstance.sign;

引数なし

引数はありません

number

このプロパティは、Durationオブジェクトが表す時間間隔の符号を返します。正の数（1）は未来を、負の数（-1）は過去を表し、0の場合は期間がゼロであることを示します。