CARL Source
Run interval
System > Automatic job > Run interval

Definition of a run interval

You have the following fields for precisely defining when automatic jobs need to be run.

 

Hour

Time when the job is run; value between 0 and 23.
Value format:

 

Minute

Minute when the job is run; value between 0 and 59.
Value format:

 

Day of the week

Number of the day of the week when the job is run; value between 1 (Sunday) and 7 (Saturday).
Value format:

 

Day of the month

Number of the day in the month when the job is run; value between 1 and 31.
Value format:

 

Months

Month when the job is run; value between 1 and 12.
Value format:

 

Special notes

It is not possible to fill in the day of the week AND the day of the month with "*." For a job that must be run every day, fill in "?" for the day of the week and "*" for the day of the month.

 

Reference information

Values accepted for the five fields used to define the execution date for automatic jobs:

Field

Values allowed

Special characters allowed

Minute

0-59

, - * /

Hour

0-23

, - * /

Day of the month

1-31

, - * ? / L W

Months

1-12 or JAN-DEC

, - * /

Day of the week

1-7 or SUN-SAT

, - * ? / L #

 

List and meaning of special characters allowed:

Character

Meaning

*

("All values")
Used to select all values in a field.
For example, "*" in the "minutes" field denotes "each minute."

?

("No value")
Useful for specifying something in one of the two domains ("Day of the month" or "Day of the week") in which characters are allowed, but not the other.
For example, if you would like to trigger a job on the third day of the month, regardless of the day of the week: "0 15 21 8 *?."

Entering the expression "0 15 21 8 * *" would result in a type exception

"Exception java.lang.UnsupportedOperationException: Support for specifying both a day-of-week AND a day-of-month setting is not implemented."

-

Used to specify a range.
For example, "10-12" in the "hour" field means "10 a.m., 11 a.m. and 12 noon."

,

Used to specify a list of values.
For example, "MON,WED,FRI" means "Monday, Wednesday and Friday."

/

Used to specify increments.
Examples:

  • "0/15" in the seconds field means "seconds 0, 15, 30 and 45."
  • "5/15" in the seconds field means "seconds 5, 20, 35 and 50."

You can also specify "/" after the "-" character, which in this case is equivalent to putting "0" before the "/."

Another example: entering "2/3" in the "Day of month" field means: "run the job every 3 days starting on the second day of the month."

L

("Last")

Used on its own, this character means "the last"
Examples:

  • Entering "L" in "Day of the week" simply means "7" or "SAT."
  • Entering "L" in "Day of the month" denotes "the last day of the month" (i.e., "day 31" for January, and "day 28" for February in a non-leap year).

If this character is used after another value, however, it means "the last [xxx]day of the month."
For example, "6L" means "the last Friday of the month."

W

("Weekday")
Used to specify the weekday (Monday-Friday) closest to the day.
For example, "15W" means “the closest weekday to the 15th day of the month”.

Examples:

  • if the 15th is a Saturday, the job will be run on Friday 14th.
  • if the 15th is a Sunday, the job will be run on Monday 16th.
  • if the 15th is a Tuesday, the job will be run on Tuesday 15th.

Special cases:

  • "1W": if the 1st is a Saturday, the job will be run on Monday 3rd because it must be run during the month.
  • "LW": the last weekday of the month.

#

Means "the Nth [xxx]day of the month."

  • "6#3": the third Friday of the month" (reminder: day '6' = Friday).
  • "2#1": the first Monday of the month.
  • "4#5": the fifth Wednesday of the month (if there are not five Wednesdays in the month, the job will not be run).

 

Examples of intervals

Interval

Hour

Minute

Day of the week

Day of the month

Months

Every day at 01:30

1

30

?

*

*

Every hour after 10 minutes have passed

*

10

?

*

*

Every first day of a month at 05:00

5

0

?

1

*

Every Tuesday at 13:25

13

25

3

*

*

From the 8th to the 10th of each month at 12:12

12

12

*

8-10

*

Every even day of the month at 23:59

23

59

*

*/2

*

Every 10 minutes starting with the hour

0

*/10

?

*

*