Calculating timeout activation times

Facebooktwitterpinterestlinkedinmail
Applies to version: 8.3 and above; Author: Tomasz Batko

Date of first timeout activation

The date starting from which timeouts are calculated, is decided according to the following conditions (the conditions are checked one by one in the following order):

  • If the timeout is activated on a specific day: the first activation is the nearest planned timeout activation that occurs after the start date and after the current date, with the successive dates calculated according to the timeout interval definition.
  • If the start date is fetched from a form field, the first activation date is the date obtained from that form field. If that date is in the past, a timeout activation occurs immediately. A timeout activation does occur on cycle start.
  • If a delay was set for the timeout, the first activation is the obtained date with added delay.
  • If the beginning date is the date of entering the step, with no defined delay, the first activation is the nearest planned activation date occurring after starting the cycle, with the successive dates calculated according to the timeout interval definition. A timeout activation does not occur on the cycle start.

 

Example (Start from date specified in form field):

Start date: May 1st ; Current date: May 8th ; Interval: 5 days;

Planned timeout dates: 1th, 11th and 16th of May.

1st of May is the first planned date, in reality however, the timeout will activate on the 8th (right after creation)

 

Example (start date is the date of entering the step):

Start date: May 1st ; Current date: May 1st ; Interval: 5 days;

Timeout dates: 6th, 11th and 16th of May.

|

Start date: May 1st ; Current date: May 8th ; Interval: 5 days;

Timeout dates: 11th, 16th and 21th of May.

 

Ignore weekends

Type: minute; hour; day

The week is treated as being 5 days long. If the activation date falls on a weekend, it is moved to the closest Monday.

 

Example (Start from date specified in form field):

Start date: 1st May (Saturday); Current Date: 3rd May (Monday); Interval: 5 days;

Ignore weekends: on

Timeout dates: 3rd May (Monday), 10th May (Monday), 24th May (Monday)

 

Example (start date is the date of entering step):

Start date: 1st May (Saturday); Current date: 3rd May (Monday); Interval: 5 days;

Ignore weekends: on

Timeout dates: 10th May (Monday), 17th May (Monday), 24th May (Monday)

|

Start date: 1st May (Saturday); Current date: 1st May; Interval: 5 days;

Ignore weekends: on

Timeout dates: 3rd May (Monday), 10th May, 17th May

|

Start date: 1st February (Monday); Current date: 1st February; Interval: 7 days;

Ignore weekends: on

Timeout dates: 10th February (Wednesday), 19th February (Friday), 2nd March (Tuesday), 11th March (Thursday), 22 March (Monday)

 

– Type: Week; Month

If the timeout activation date occurs on a weekend, it is moved to the nearest Monday.

 

Example:

Start date: 1st May (Saturday); Current date: 5th May (Wednesday); Interval: 1 week;

Ignore weekends: on

Timeout  dates: 10th May (Monday), 17th May (Monday), 24th May (Monday)

|

Start date: 1st February (Monday); Current date: 1st February (Monday); Interval: 1 week;

Ignore weekends: on

Timeout dates: 8th February (Monday), 15th February (Monday), 22nd February (Monday)

|

Setting a specific day of a weekly or monthly cycle – either day of the week or day of the month.

The first activation will occur on the nearest specified type of day (either a day of the week or a day of the month) that occurs after the start date.

 

Example:

Start date: 1st May (Saturday); Current date: 1st May (Saturday); Interval: 1 week;

Day in cycle: Monday

Timeout dates: 3rd May (Monday) , 10th May (Monday) , 17th May (Monday)

|

Start date: 1st  May (Saturday); Current date: 3rd May (Monday); Interval: 1 week;

Day in cycle: Monday

Timeout dates: 10th May (Monday) , 17th May (Monday) , 24th May (Monday)

|

Start date: 1st January 2010; Current date: 1st January 2010; Interval: 1 month;

Day in cycle: 31

Timeout dates: 31st January (Sunday) , 28th February (Sunday), 31st March (Wednesday)

 

If setting a day in a cycle is combined with ignoring weekends, the activation date will occur on the first day following the specified type of day that isn’t a weekend.

 

Example:

Start date: 1st January 2010; Current date: 1st January 2010; Interval: 1 month;

Day in cycle: 31

Ignore weekends: on

Timeout dates: 1st February (Monday) , 1st March (Monday), 31st March (Wednesday)

|

Start Date: 1st May (Saturday); Current Date: 1st May (Saturday); Interval: 1 week;

Day in cycle: Sunday

Ignoring weekends: on

Timeout dates: 3rd May (Monday) , 10th May (Monday) , 17th May (Monday)

 

Delayed activation

Defining a delay will cause that many days to be added to the start day.

 

Example:

Start date: 1st March 2010; Current date: 1st March 2010; Interval: 1 Month;

Delay: 7 days

Timeout dates: 8th March, 8th April, 8th May

 

If the option to ignore weekends was selected, only business/working days count towards the delay time.

 

Example:

Start date: 1st March 2010; Current date: 1st March 2010; Interval: 1 month;

Delay: 7 days;

Ignore weekends: on

Timeout Dates:  10th March, 12th April, 10th May

 

Activation at a specific hour

Type: minute; hour;

A day is treated as a timeframe, defined by activation hours. If the activation date falls outside these activation hours (the given day’s timeframe) the remaining time will be carried over to the next day.

 

Example (Activation hours: 10:00-15:00, start from date in form field):

Start date: 1st May 2010 08:30; Current date: 1st May 2010 09:00 Interval: 3 hours

Timeout dates: 1st May 10:00, 1st May 13:00,  2nd May 11:00

 

Example (Activation hours: 10:00-15:00, start on step entry):

Start date: 1st May 2010 08:30; Current date: 1st May 2010 09:00 Interval: 3 hours

Timeout dates: 1st May 13:00, 2nd May 11:00,  2nd May 14:00

 

Type: week; month;

If the activation date falls outside activation hours, the cycle is calculated from the start nearest activation timeframe.

 

Example (Activation hours: 10:00-15:00, start from date in form field):

Start date: 1st May 2010 16:00; Current date: 1st May 2010 16:00 Interval:  2 days

Timeout dates: 2nd May 10:00, 4th May 10:00,  6th May 10:00

 

Example (Activation hours: 10:00-15:00, start on step entry):

Start date: 1st May 2010 16:00; Current date: 1st May 2010 16:00 Interval:  2 days

Timeout dates: 4nd May 10:00, 6th May 10:00,  8th May 10:00

Leave a Reply

Your email address will not be published. Required fields are marked *