CRON expression details

更新时间:
复制 MD 格式

A CRON expression is a string that consists of six or seven space-separated fields. Each field has a specific meaning.

CRON expressions have two syntax formats:

  • Second Minute Hour Day-of-month Month Day-of-week Year

  • Second Minute Hour Day-of-month Month Day-of-week

Allowed values for each field

Field

Allowed values

Allowed special characters

Notes

Second

0–59

- * /

-

Minute

0–59

- * /

-

Hour

0–23

- * /

-

Date

1–31

- * ? / L W C

-

Month

1–12

JAN-DEC - * /

-

Day-of-week

1–7

SUN-SAT - * ? / L C #

1 represents Sunday, 2 represents Monday, and so on.

Year (optional)

empty, 1970–2099

, - * /

This value is automatically generated and not displayed by the tool.

Meanings of special characters

Character

Meaning

Example

*

Matches any value in the field.

Using * in the minute field triggers the event every minute.

?

Matches any value. This character can be used only in the day-of-month and day-of-week fields because these two fields can conflict.

To trigger a schedule on the 20th of each month, regardless of the day of the week, use the following expression: 13 13 15 20 * ?. Because the day-of-month field is set to 20, the day-of-week field must be ?. You cannot use *. If you use *, it means the trigger fires on any day of the week, which conflicts with the specified 20th day of the month and makes the expression invalid.

-

Specifies a range.

Using 5-20 in the minute field triggers the event every minute from the 5th to the 20th minute.

/

Specifies increments. The trigger starts at a specific time and then fires at a fixed interval.

Using 5/20 in the minute field triggers the event at the 5th minute and every 20 minutes thereafter. For example, the trigger fires at 5, 25, and 45 minutes past the hour.

,

Specifies the enumeration values.

Using 5,20 in the minute field triggers the event at the 5th and 20th minutes of the hour.

L

Stands for "last". This character can be used only in the day-of-month and day-of-week fields.

Using 5L in the day-of-week field means the trigger fires on the last Thursday of the month.

W

Stands for "weekday" (Monday to Friday). This character can be used only in the day-of-month field. The system triggers the event on the nearest weekday to the specified day.

Using 5W in the day-of-month field means the trigger fires on the weekday nearest to the 5th of the month. For example, if the 5th is a Saturday, the trigger fires on Friday the 4th. If the 5th is a Sunday, the trigger fires on Monday the 6th. If the 5th is a weekday, the trigger fires on the 5th. The search for the nearest weekday does not cross into another month.

LW

You can use these two characters together to represent the last workday of a month, such as the last Friday.

#

Specifies the "nth" day of the week in a month. This character can be used only in the day-of-week field.

Using 4#2 in the day-of-week field means the second Wednesday of the month. In this example, 4 represents Wednesday and 2 represents the second instance.

Examples

  • */5 * * * * ?: Executes every 5 seconds.

  • 0 */1 * * * ?: Executes every 1 minute.

  • 0 0 2 1 * ?: Executes at 2:00 AM on the 1st of every month.

  • 0 15 10 ? * MON-FRI: Executes at 10:15 AM every Monday through Friday.

  • 0 15 10 ? 6L 2002-2006: Executes at 10:15 AM on the last Friday of every month from 2002 to 2006.

  • 0 0 23 * * ?: Executes at 11:00 PM every day.

  • 0 0 1 * * ?: Executes at 1:00 AM every day.

  • 0 0 1 1 * ?: Executes at 1:00 AM on the 1st of every month.

  • 0 0 23 L * ?: Executes at 11:00 PM on the last day of every month.

  • 0 0 1 ? * L: Executes at 1:00 AM every Sunday.

  • 0 26,29,33 * * * ?: Executes at 26, 29, and 33 minutes past the hour.

  • 0 0 0,13,18,21 * * ?: Executes every day at 12:00 AM, 1:00 PM, 6:00 PM, and 9:00 PM.

  • 0 0 10,14,16 * * ?: Executes every day at 10:00 AM, 2:00 PM, and 4:00 PM.

  • 0 0/30 9-17 * * ?: Executes every 30 minutes from 9:00 AM to 5:30 PM.

  • 0 0 12 ? * WED: Executes at 12:00 PM (noon) every Wednesday.

  • 0 0 12 * * ?: Executes at 12:00 PM (noon) every day.

  • 0 15 10 ? * *: Executes at 10:15 AM every day.

  • 0 15 10 * * ?: Executes at 10:15 AM every day.

  • 0 15 10 * * ? *: Executes at 10:15 AM every day.

  • 0 15 10 * * ? 2005: Executes at 10:15 AM every day in 2005.

  • 0 * 14 * * ?: Executes every minute from 2:00 PM to 2:59 PM every day.

  • 0 0/5 14 * * ?: Executes every 5 minutes from 2:00 PM to 2:55 PM every day.

  • 0 0/5 14,18 * * ?: Executes every 5 minutes from 2:00 PM to 2:55 PM and from 6:00 PM to 6:55 PM every day.

  • 0 0-5 14 * * ?: Executes every minute from 2:00 PM to 2:05 PM every day.

  • 0 10,44 14 ? 3 WED: Executes at 2:10 PM and 2:44 PM on every Wednesday in March.

  • 0 15 10 ? * MON-FRI: Executes at 10:15 AM every Monday through Friday.

  • 0 15 10 15 * ?: Executes at 10:15 AM on the 15th of every month.

  • 0 15 10 L * ?: Executes at 10:15 AM on the last day of every month.

  • 0 15 10 ? * 6L: Executes at 10:15 AM on the last Friday of every month.

  • 0 15 10 ? * 6L 2002-2005: Executes at 10:15 AM on the last Friday of every month from 2002 to 2005.

  • 0 15 10 ? * 6#3: Executes at 10:15 AM on the third Friday of every month.