isTimeInRange( )

日付または日時の値が指定された範囲内にあるかどうかを確認します。

構文

時間要素のない日付型変数を使用する場合、関数は時間を'00:00:00'とみなします。

isTimeInRange(dateToCheck, dateFrom, dateTo, inclusive)

パラメータ

パラメータ 必須/オプション 説明
dateToCheck 必須 範囲内かどうかを評価する日時値。
dateFrom 必須 評価する日付範囲の開始日時の値。
dateTo 必須 評価する日付範囲の終了日時の値。
inclusive 必須 範囲内評価の範囲制限を含めるかどうかを決定します。次のいずれかのオプションを使用できます。
  • 'both': 日付制限dateToとdateFromの両方を範囲チェックに含めます。
    dateFrom <= dateToCheck && dateToCheck <= dateTo
  • 'from': 範囲チェックにdateFromのみを含めます。
    dateFrom <= dateToCheck && dateToCheck < dateTo
  • 'to': 範囲チェックにdateToのみを含めます。
    dateFrom < dateToCheck && dateToCheck <= dateTo
  • 'no': 範囲チェックに日付制限dateToおよびdateFromを含めないでください。
    dateFrom < dateToCheck && dateToCheck < dateTo

戻り値

ブール(trueまたはfalse)の値:
  • 日付が範囲内にある場合は「真」。
  • 日付が範囲外の場合は「False」。

例

例3-29日時値の確認

// Given 3 form questions of type DateTime are defined in the rule as variables
if (isTimeInRange(dateToCheck, dateFrom, dateTo, "both")) {
  return true;
} else {
  return false;
}
 
// Triggers query if dateToCheck is not in range (dateFrom <= dateToCheck && dateToCheck <= dateTo)

例3-30 3つのハードコードされた日時アイテムの比較

var dateToCheck = new Date("March 1, 2020 14:00:00");
var dateFrom = new Date("March 1, 2020 12:00:00");
var dateTo = new Date("March 1, 2020 13:00:00");
 
if (!isTimeInRange(dateToCheck, dateFrom, dateTo, "both") {
  return false;
} else {
  return true;
}
 
//Triggers query since dateToCheck is not in range (dateFrom <= dateToCheck && dateToCheck <= dateTo)

例3-31 2つの時間項目の比較

var dateToCheck= new Date( '01-01-001 ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
return isTimeInRange(dateToCheck, dateFrom, dateTo, "both");

親トピック: 日付と時間ファンクション