addTimeInMinutes( )

Add a specific number of minutes to a date or date/time value. This function is useful when you need to evaluate if a date is exceeded by a specific amount of time.

This rule helper function is approved for use in Screen Candidate rule execution.

Syntax

addTimeInMinutes(startTime, numberOfMinutes)

Parameters

Parameter	Required or 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);