cron表達式詳解

  • 2020 年 3 月 12 日
  • 筆記

本文轉載自部落格:

https://www.cnblogs.com/junrong624/p/4239517.html

Cron表達式是一個字元串,字元串以5或6個空格分隔,分為6或7個區域,每一個域代表一個含義,Cron有如下兩種語法格式:

Seconds Minutes Hours DayofMonth Month DayofWeek Year 或

Seconds Minutes Hours DayofMonth Month DayofWeek

每一個區域可出現的字元如下:

Seconds:可出現", - * /"四個字元,有效範圍為0-59的整數

Minutes:可出現", - * /"四個字元,有效範圍為0-59的整數

Hours:可出現", - * /"四個字元,有效範圍為0-23的整數

DayofMonth:可出現", - * / ? L W C"八個字元,有效範圍為0-31的整數

Month:可出現", - * /"四個字元,有效範圍為1-12的整數或JAN-DEc

DayofWeek:可出現", - * / ? L C #"四個字元,有效範圍為1-7的整數或SUN-SAT兩個範圍。1表示星期天,2表示星期一, 依次類推

Year:可出現", - * /"四個字元,有效範圍為1970-2099年

每一個區域都使用數字,但還可以出現如下特殊字元,它們的含義是:

(1)*:表示匹配該域的任意值,假如在Minutes域使用*, 即表示每分鐘都會觸發事件。

(2)?:只能用在DayofMonth和DayofWeek兩個域。它也匹配域的任意值,但實際不會。因為DayofMonth和 DayofWeek會相互影響。例如想在每月的20日觸發調度,不管20日到底是星期幾,則只能使用如下寫法:13 13 15 20 * ?, 其中最後一位只能用?,而不能使用,如果使用表示不管星期幾都會觸發,實際上並不是這樣。

(3)-:表示範圍,例如在Minutes域使用5-20,表示從5分到20分鐘每分鐘觸發一次

(4)/:表示起始時間開始觸發,然後每隔固定時間觸發一次,例如在Minutes域使用5/20,則意味著5分鐘觸發一次,而25,45等分別觸發一次.

(5),:表示列出枚舉值值。例如:在Minutes域使用5,20,則意味著在5和20分每分鐘觸發一次。

(6)L:表示最後,只能出現在DayofWeek和DayofMonth域,如果在DayofWeek域使用5L,意味著在最後的一個星期四觸發。

(7)W: 表示有效工作日(周一到周五),只能出現在DayofMonth域,系統將在離指定日期的最近的有效工作日觸發事件。例如:在 DayofMonth使用5W,如果5日是星期六,則將在最近的工作日:星期五,即4日觸發。如果5日是星期天,則在6日(周一)觸發;如果5日在星期一 到星期五中的一天,則就在5日觸發。另外一點,W的最近尋找不會跨過月份

(8)LW:這兩個字元可以連用,表示在某個月最後一個工作日,即最後一個星期五。

(9)#:用於確定每個月第幾個星期幾,只能出現在DayofMonth域。例如在4#2,表示某月的第二個星期三。

舉幾個例子:

0 0 2 1 * ? * 表示在每月的1日的凌晨2點調度任務

0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15執行作業

0 15 10 ? 6L 2002-2006 表示2002-2006年的每個月的最後一個星期五上午10:15執行作

一個cron表達式有至少6個(也可能7個)有空格分隔的時間元素。

其中每個元素可以是一個值(如6),一個連續區間(9-12),一個間隔時間(8-18/4)(/表示每隔4小時),一個列表(1,3,5),通配符。由於月份中的日期星期中的日期這兩個元素互斥的,必須要對其中一個設置?

0 0 10,14,16 * * ? 每天上午10點,下午2點,4點

0 0/30 9-17 * * ? 朝九晚五工作時間內每半小時

0 0 12 ? * WED 表示每個星期三中午12點

"0 0 12 * * ?" 每天中午12點觸發

"0 15 10 ? * *" 每天上午10:15觸發

"0 15 10 * * ?" 每天上午10:15觸發

"0 15 10 * * ? *" 每天上午10:15觸發

"0 15 10 * * ? 2005" 2005年的每天上午10:15觸發

"0 * 14 * * ?" 在每天下午2點到下午2:59期間的每1分鐘觸發

"0 0/5 14 * * ?" 在每天下午2點到下午2:55期間的每5分鐘觸發

"0 0/5 14,18 * * ?" 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發

"0 0-5 14 * * ?" 在每天下午2點到下午2:05期間的每1分鐘觸發

"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44觸發

"0 15 10 ? * MON-FRI" 周一至周五的上午10:15觸發

"0 15 10 15 * ?" 每月15日上午10:15觸發

"0 15 10 L * ?" 每月最後一日的上午10:15觸發

"0 15 10 ? * 6L" 每月的最後一個星期五上午10:15觸發

"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最後一個星期五上午10:15觸發

"0 15 10 ? * 6#3" 每月的第三個星期五上午10:15觸發

有些子表達式能包含一些範圍或列表

例如:子表達式(天(星期))可以為 MON-FRIMON,WED,FRIMON-WED,SAT

*字元代表所有可能的值

因此,*在子表達式(月)里表示每個月的含義,*在子表達式(天(星期))表示星期的每一天

/字元用來指定數值的增量

例如:在子表達式(分鐘)里的0/15表示從第0分鐘開始,每15分鐘

在子表達式(分鐘)里的3/20表示從第3分鐘開始,每20分鐘(它和3,23,43)的含義一樣

字元僅被用於天(月)和天(星期)兩個子表達式,表示不指定值

當2個子表達式其中之一被指定了值以後,為了避免衝突,需要將另一個子表達式的值設為

L 字元僅被用於天(月)和天(星期)兩個子表達式,它是單詞last的縮寫

但是它在兩個子表達式里的含義是不同的。

在天(月)子表達式中,L表示一個月的最後一天

在天(星期)自表達式中,L表示一個星期的最後一天,也就是SAT

如果在L前有具體的內容,它就具有其他的含義了

例如:6L表示這個月的倒數第6天,FRIL表示這個月的最一個星期五

注意:在使用L參數時,不要指定列表或範圍,因為這會導致問題

欄位

允許值

允許的特殊字元

0-59

, – * /

0-59

, – * /

小時

0-23

, – * /

日期

1-31

, – * ? / L W C

月份

1-12或者 JAN-DEC

, – * /

星期

1-7或者 SUN-SAT

, – * ? / L C #

年(可選)

留空, 1970-2099

, – * /

Cron表達式範例:

每隔5秒執行一次:  */5 * * * * ?  每隔1分鐘執行一次:  0 */1 * * * ?  每天23點執行一次:  0 0 23 * * ?  每天凌晨1點執行一次:  0 0 1 * * ?  每月1號凌晨1點執行一次:  0 0 1 1 * ?  每月最後一天23點執行一次:  0 0 23 L * ?  每周星期天凌晨1點執行一次:  0 0 1 ? * L  在26分、29分、33分執行一次:  0 26,29,33 * * * ?  每天的0點、13點、18點、21點都執行一次:  0 0 0,13,18,21 * * ?