isDateInRange( )

日付が特定の範囲内にあるかどうかを確認します。

構文

この関数は、時間要素を含まず、日付の一部を含まない日付タイプの変数を比較するために使用されます。日時タイプ・パラメータを使用する場合、関数は日付部分のみを考慮し、時間要素は無視されます。

ヒント:

  • isTimeInRange( )ヘルパー関数を使用すると、2つの日時アイテムを比較できます。
  • 日付の質問に日付要素の一部が含まれている場合は、getDatesCompareResult( )ヘルパー関数を使用します。 
isDateInRange(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-23日付値の確認

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

例3-24 3つのハードコードされた日付の比較

var dateToCheck = new Date("April 1, 2020");
var dateFrom = new Date("March 1, 2020");
var dateTo = new Date("March 30, 2020");
 
if (!isDateInRange(dateToCheck, dateFrom, dateTo, "both") {
  return false;
} else {
  return true;
}
 
//Triggers query since dateToCheck is not in range (dateFrom <= dateToCheck && dateToCheck <= dateTo)

親トピック: 日付と時間の関数