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-FRI
,MON,WED,FRI
,MON-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 * * ?