addTimeInMinutes( )

Add a specific number of minutes to a date or date/time value.

Syntax

Tip:

This function is useful when you need to evaluate if a date is exceeded by a specific amount of time.
addTimeInMinutes(startTime, numberOfMinutes)

Parameters

Parameter Required/Optional Description
startTime Required Date or date/time value to add minutes to.
numberOfMinutes Required Number of minutes to be added to the passed in date.

Return value

A new date/time value increased by the number of minutes specified.

Examples

Example 3-36 dateTime1 cannot be greater than 30 minutes from dateTime2

// Given 2 form questions of type DateTime are defined in the rule as variables
if (addTimeInMinutes(dateTime1, 30) > dateTime2) {
  return false;
} else {
  return true;
}
 
// Trigges query that dateTime1 cannot be > 30 minutes from dateTime2

Example 3-37 Add minutes to Time Items

var dateTime1= new Date( '01-Jan-0001 ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
return addTimeInMinutes(dateTime1, 30);

Example 3-38 Add minutes to partial date items

var dateTime1= new Date( ruleTimeItem.getYear() + '-' +  ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
return addTimeInMinutes(dateTime1, 30);