This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Fixes link

...

In the temporal expression definitions that follow, the expressions will 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(15, 15)

An event that occurs on Monday, Tuesday, and Wednesday:

Code Block
   DayOfWeekRange(Monday, 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)

...

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, ...)

...

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)

...

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.