【JavaScript ECMAScript】Temporal::Temporal.Duration.prototype.blankインスタンスアクセサプロパティの使い方
Temporal.Duration.prototype.blankインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.Duration.prototype.blankプロパティは、Temporal.Durationオブジェクトが「空の期間」であるかどうかを示す真偽値を保持するプロパティです。Temporal.Durationオブジェクトは、年、月、日などの様々な時間単位で構成される特定の期間を表すためのものです。このblankプロパティは、その期間オブジェクトが保持するすべての時間単位の値(例えば、年、月、週、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒)が、一つ残らずすべて0である場合にtrueを返します。
もし、これらの時間単位のうち、いずれか一つでも0以外の値を持つ場合は、falseを返します。このプロパティは、ある期間が実質的に何もない状態、すなわちゼロ期間であるかどうかを簡単に確認したい場合に非常に便利です。例えば、期間の計算結果が意味のある値を持つのか、それとも単に「長さゼロ」の期間なのかを判断する際に利用できます。blankプロパティは読み取り専用であり、その値を直接変更することはできません。期間が空であることを判定するための明確かつ簡潔な手段を提供します。
公式リファレンス: Temporal.Duration.prototype.blank
構文(syntax)
1const duration = new Temporal.Duration(0, 0, 0, 0, 0, 0, 0, 0, 0, 0); 2const isBlank = duration.blank;
引数(parameters)
引数なし
引数はありません
戻り値(return)
boolean
Temporal.Duration.prototype.blank は、この Duration オブジェクトが空(つまり、すべての単位がゼロ)である場合に true を返します。それ以外の場合は false を返します。