addTimeInHours( )

Add a specific number of hours 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

addTimeInHours(startTime, numberOfHours)

Parameters

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

Return value

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

Examples

Example 3-33 dateTime1 cannot be greater than 12 hours from dateTime2

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

Example 3-34 Add hours to time items

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

Example 3-35 Add hours to partial date items

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