addTimeInHours( )

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

addTimeInHours(startTime, numberOfHours)

Parameters

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