...
In the temporal expression definitions that follow, the expressions will be shown like use this notation:
Code Block |
---|
Expression(parameter1, parameter2, ...) Collection: Member Expression(parameter1, parameter2, ...) Member Expression(parameter1, parameter2, ...) |
...
Range Expressions
Code Block |
---|
MinuteRange(start, end)
HourRange(start, end)
DayOfWeekRange(start, end)
DayOfMonthRange(start, end)
MonthRange(start, end)
DateRange(start, end)
|
...
An event that occurs during the 3 o'clock PM hour:
Code Block |
---|
HourRange(start = 15, end = 15) |
An event that occurs on Monday, Tuesday, and Wednesday:
Code Block |
---|
DayOfWeekRange(start = Monday, end = Wednesday) |
Day In Month Expression
Code Block |
---|
DayInMonth(day of week, occurance)
|
...
An event that occurs on the first Monday of the month:
Code Block |
---|
DayInMonth(Monday, 1)
|
An event that occurs on the fourth Thursday of the month:
Code Block |
---|
DayInMonth(Thursday, 4)
|
An event that occurs on the last Saturday of the month:
Code Block |
---|
DayInMonth(Saturday, -1)
|
Frequency Expression
Code Block |
---|
Frequency(start date-time, frequency type, frequency count)
|
...
An event that occurs every day beginning January 1, 2010:
Code Block |
---|
Frequency(2010-01-01, day, 1)
|
An event that occurs every two weeks beginning January 1, 2010:
Code Block |
---|
Frequency(2010-01-01, day, 14)
|
...
Union Expression
Code Block |
---|
Union:
Expression(parameter1, parameter2, ...)
Expression(parameter1, parameter2, ...)
...
|
Intersection Expression
Code Block |
---|
Intersection:
Expression(parameter1, parameter2, ...)
Expression(parameter1, parameter2, ...)
...
|
Difference Expression
Code Block |
---|
Difference:
Include:
Expression(parameter1, parameter2, ...)
Exclude:
Expression(parameter1, parameter2, ...)
|
...
An event that occurs at 8:00 AM:
Code Block |
---|
Intersection:
MinuteRange(0, 0)
HourRange(8, 8)
|
An event that occurs Monday, Tuesday, Wednesday, and Saturday:
Code Block |
---|
Union:
DayOfWeekRange(Monday, Wednesday)
DayOfWeekRange(Saturday, Saturday)
|
An event that occurs Monday, Tuesday, Wednesday, and Saturday at 8:00 AM:
Code Block |
---|
Intersection:
MinuteRange(0, 0)
HourRange(8, 8)
Union:
DayOfWeekRange(Monday, Wednesday)
DayOfWeekRange(Saturday, Saturday)
|
An event that occurs Monday, Tuesday, Wednesday, and Saturday at 8:00 AM except the last Saturday of the month:
Code Block |
---|
Difference:
Include:
Intersection:
MinuteRange(0, 0)
HourRange(8, 8)
Union:
DayOfWeekRange(Monday, Wednesday)
DayOfWeekRange(Saturday, Saturday)
Exclude:
DayInMonth(Saturday, -1)
|
The Substitution Expression
The Substitution temporal expression works a lot like a Difference expression, except it provides a substitute for the exclusion.
Info |
---|
The Substitution expression is not available in Release 9.04. |
Code Block |
---|
Substitution: Include: Expression(parameter1, parameter2, ...) Exclude: Expression(parameter1, parameter2, ...) Substitute: Expression(parameter1, parameter2, ...) |
Substitution Examples
An event that occurs on the first Monday of the month, except on Labor Day (first Monday in September) - where it is rescheduled for the following Tuesday:
Code Block |
---|
Substitution:
Include:
DayInMonth(Monday, 1)
Exclude:
Intersection:
DayInMonth(Monday, 1)
MonthRange(9, 9)
Substitute:
DayOfWeekRange(Tuesday, Tuesday)
|
An event that occurs Monday, Tuesday, Wednesday, and Saturday at 8:00 AM except the last Saturday of the month - where it is rescheduled for the following Sunday at 1:00 PM:
Code Block |
---|
Substitution:
Include:
Intersection:
MinuteRange(0, 0)
HourRange(8, 8)
Union:
DayOfWeekRange(Monday, Wednesday)
DayOfWeekRange(Saturday, Saturday)
Exclude:
DayInMonth(Saturday, -1)
Substitute:
Intersection:
MinuteRange(0, 0)
HourRange(13, 13)
DayOfWeekRange(Sunday, Sunday)
|
What's Next?
If you would like to take the Temporal Expression tutorial, go here.
If you would like to see the Temporal Expression demo data, go here.
If you would like to see the Temporal Expression Java API, go here.