The Nth Day Timer Condition is triggered once every year, every month or every week.

Managing Nth Day Timer Conditions

Via Java API

After creating a condition as described in Managing Conditions  you can configure it by using the following methods:

• setStartTime - The condition is inactive before that date.
• setDay - The condition can be configured not to trigger at the beginning of the period but to wait a number of days. This method lets you set that number.
• setIntervalType - Excepts one of the interval type constants - year, month or day.
• setTime - Time of the day, when the condition should be triggered, represented by three integers (hours, minutes and seconds)

After you configure your condition, call the save method. The Condition Provider will save the configuration as a Config Tree configurable, in XML format.

Via ConfigTree

All conditions are stored in the Config Tree, which allows you to import/export them and to add/edit them by simply creating and modifying XML files.

The following example contains the configuration XML of an Nth Day Timer Condition, named "My Nth Day Timer". The timer becomes active at Mon Nov 28 2011 16:00:00 GMT+0200 (specified as 1322488800000 milliseconds to the startTime condition property), and it ends at Nov 30 2021 15:15:00 GMT+0200 (specified as 1638278100000 milliseconds to the endTime condition property). The event will be fired at 00:05:55 (specified as hour - 22, minute - 5 and seconds - 55) on Oct 27 (specified as day set to 300) and will be repeated 8 times (set as repeatCount), i.e. 8 years.

<config name="My Nth Day Timer">

<property key="id_gen" value="1" type="long"/>

<config name="8"> <property key="day" value="300" type="int"/>

  <property key="endTime" value="1638278100000" type="long"/>

  <property key="hour" value="22" type="int"/>

  <property key="intevalType" value="3" type="int"/>

  <property key="minute" value="5" type="int"/>

  <property key="name" value="My Nth Day Timer" type="string"/>

  <property key="repeatCount" value="8" type="int"/>

  <property key="seconds" value="55" type="int"/>

  <property key="startTime" value="1322488800000" type="long"/>

</config>

</config>