Date range type（日付期間型）

概要

この型は 2 つの日付で構成され、その間の期間を表します。スケジューリングや予約システムなどを構築する際に使用します。

is in

指定した値が、引数として渡されたリスト内に含まれている場合に true を返します。

is not in

指定した値が、引数として渡されたリスト内に含まれていない場合に true を返します。

:start

レンジの開始日時（最小値）を返します。

:end

レンジの終了日時（最大値）を返します。

:center

開始と終了の平均を取り、レンジの中央（中心時刻）を返します。

contains range

第1のレンジと第2のレンジを比較し、第1のレンジが第2のレンジを含んでいれば yes を返します。
「含む」とは、第2レンジの開始が第1レンジの開始以上であり、終了も第1レンジの終了以下であることを意味します。
つまり、2つのレンジが同じ場合も yes になります。

contains (point)

レンジと 1 つの日付を比較し、その日付がレンジ内に含まれていれば yes を返します。
日付がレンジの開始以上かつ終了以下であれば「含まれている」と判断します。

is contained by

第1のレンジが第2のレンジに含まれている場合に yes を返します。
「含まれている」は、以下の条件を意味します。

• 第1レンジの開始 ≥ 第2レンジの開始
• 第1レンジの終了 ≤ 第2レンジの終了
  レンジが全く同じ場合も yes になります。

overlaps with

第1レンジと第2レンジを比較し、少しでも重複があれば yes を返します。
例えば、第1レンジの終了が第2レンジの開始と等しい場合や、その逆のケースでも yes となります。

is after

第1レンジの開始が、第2レンジの終了よりも厳密に後である場合に yes を返します。

is after (point)

レンジの開始が、指定した日付よりも厳密に後である場合に yes を返します。

is before

第1レンジの終了が、第2レンジの開始よりも厳密に前である場合に yes を返します。

is before (point)

レンジの終了が、指定した日付よりも厳密に前である場合に yes を返します。