isTimeInRange( )

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

構文

注意:

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

isTimeInRange(dateToCheck, dateFrom, dateTo, inclusive)

パラメータ

dateToCheck

チェックする日付または日時の値。

dateFrom

日付または日時値の範囲の開始。

dateTo

日付または日付/時刻の値範囲の終了。

inclusive

文字列: 'both'、'from'、'to'または'no'。

• 'both': 範囲チェック(dateFrom <= dateToCheck && dateToCheck <= dateTo)にdateToおよびdateFromの日付を含めます
• 'from': 範囲チェック(dateFrom <= dateToCheck && dateToCheck < dateTo)にdateFromのみを含めます
• 'to': 範囲チェック(dateFrom < dateToCheck && dateToCheck <= dateTo)にdateToのみを含めます
• 'no': 範囲チェック(dateFrom < dateToCheck && dateToCheck < dateTo)にdateToまたはdateFromを含めないでください

戻り値

日付または日時が範囲内にある場合は true、そうでない場合は false。

例3-28日時値の確認

// 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-29ハードコードされた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-30 2つの時間項目の比較

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