areDateTimesEqual( )
Compare two date or date/time values to determine if they are equivalent.
Syntax
When using date type variables with no time elements, function considers time as '00:00:00'.
areDateTimesEqual(date1, date2)
Parameters
Parameter | Required/Optional | Description |
---|---|---|
date1 |
Required | First date/time value to compare. |
date2 |
Required | Second date/time value to compare. |
Return value
Boolean (true or false) value:
- True if date/times are equal.
- False if date/times are different.
Examples
Example 3-25 Compare two date/time items
// Given 2 form questions of type DateTime are defined in the rule as variables
if (areDateTimesEqual(date1, date2)) {
return false;
} else {
return true;
}
// Triggers query if dates are equal.
Example 3-26 Compare two hard-coded date/time items
var date1 = new Date("March 1, 2020 13:00:00");
var date2 = new Date("March 1, 2020 12:00:00");
if (!areDateTimesEqual(date1, date2)) {
return false;
} else {
return true;
}
// Triggers query since dates are not equal.
Example 3-27 Compare two time items
var date1 = new Date( '01-Jan-0001 ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
var date2 = new Date( '01-Jan-0001 ' + ruleTimeItem2.getHour() + ':' + ruleTimeItem2.getMinute() + ':' + ruleTimeItem2.getSecond() );
return areDateTimesEqual(date1, date2);
Example 3-28 Compare two partial date items
var date1 = new Date( ruleTimeItem.getYear() + '-' + ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
var date2 = new Date( ruleTimeItem.getYear() + '-' + ruleTimeItem.getMonth() + '-' + ruleTimeItem.getDay() + ' ' + ruleTimeItem.getHour() + ':' + ruleTimeItem.getMinute() + ':' + ruleTimeItem.getSecond() );
return areDateTimesEqual(date1, date2);
Parent topic: Date and time functions