Timer

Allows the execution of a Function at a specified time or interval.

Properties

Include days

Allow the user to specify a list of days on which the timer should run. Possible values include "EveryDay" (Mon-Sun), "Weekdays" (Mon-Fri), or a comma-separated list of days or dates, e.g. "Monday, Tuesday, Saturday" or "2015-05-09, 2015-05-15" (date format yyyy-MM-dd). You can either enter these values manually, or use the Include days editor to specify the allowed days.

Exclude days

Allow the user to specify a list of days on which the timer should not run. See the Include days property for possible values. You can either enter these values manually, or use the Exclude days editor to specify the allowed days.

Mode

The execution mode of the timer. Select either 'Interval' or 'Specific times'.

When the Mode is 'Interval', also set these properties:

Run every

Specify the interval (time format HH:mm:ss) at which the timer should execute. E.g. "00:00:30" will create a timer that will execute every 30 seconds.

Starting time

Specify the starting time (time format HH:mm:ss) of the timer. E.g. "14:10:00" will create a timer that will start execution at 10 minutes past two in the afternoon.

Run for

The duration (time format HH:mm:ss) that the timer will be active for. E.g. "00:45:00" will create a timer that is active for 45 minutes.

When the Mode is 'Specific times', also set this property:

Run at

Specify the exact times (time format HH:mm:ss) in a comma-separated list of values. E.g. "09:10:00, 15:00:00" will create a timer that will execute at 10 minutes past 9 in the morning, as well as at 3 o'clock in the afternoon.

Events

TimerEvent

Activated when the timer interval has elapsed, or when a specific time has been reached.

Examples

Execute every day (Mon-Sun), starting at 12 o'clock at night and run for 24 hours.

Interval execution times are:

00:00:00

01:00:00

02:00:00

...

22:00:00

23:00:00

Execute every day of the week (Mon-Fri), excluding Tuesday, starting at 11 o'clock at night and run for 2 hours.

Interval execution times are:

Monday 23:00:00

Monday 23:30:00

Tuesday 00:00:00

Tuesday 00:30:00

Wednesday 23:00:00

Wednesday 23:30:00

etc.

Note that the exclusion day is used when determining the start time of the timer. In this example there will be timer events on the Tuesday morning, because they form part of the interval range that started on the Monday night at 11 o'clock.

Execute on the 15th and 16th of September 2015 at 9 o'clock in the morning and 2 o'clock in the afternoon.