Cron 表達式是一個字符串,分爲 6 或 7 個域,每一個域代表一個含義,Cron 表達式
對英文大小寫也不敏感。
Cron 有如下兩種語法格式:
1. Seconds Minutes Hours Day Month Week Year
2. Seconds Minutes Hours Day Month Week
一、Cron 表達式結構
Cron 從左到右(用空格隔開):秒 分 小時 月份中的日期 月份 星期中的日期 年份
二、Cron 表達式中各字段含義
位置 | 時間域(en) | 時間域(ch) | 允許值範圍 | 允許特殊字符 |
---|---|---|---|---|
1 | Seconds | 秒 | 0-59 | , - * / |
2 | Minutes | 分鐘 | 0-59 | , - * / |
3 | Hours | 小時 | 0-23 | , - * / |
4 | Day | 日 | 1-31 | , - * / L W C |
5 | Month | 月 | 1-12 | , - * / |
6 | Week | 星期 | 1-7(1:星期天,6:星期六) | , - * ? / L C # |
7 | Year | 年(可選) | 1970-2099 | , - * / |
Cron 表達式
的各字段除允許設置數值外,還可使用指定的特殊字符來提供列表、範圍、通配符等功能,細說如下:
-
星號(*):用在所有字段中,表示對應時間域的每一個時刻。例如,*在分鐘字段時,表示“每分鐘”;
-
問號(?):只在日期和星期字段中使用,它通常指定爲“無意義的值”,相當於佔位符;
-
減號(-):表示一個範圍。例如在小時字段中使用“10-12”,則表示從 10 到 12 點,即 10,11,12;
-
逗號(,):表示一個列表值。例如在星期字段中使用“MON,WED,FRI”,則表示星期一,星期三和星期五;
-
斜槓(/):x/y 表達一個等步長序列,x 爲起始值,y 爲增量步長值。例如在分鐘字段中使用 0/15,則表示爲 0,15,30 和 45 秒,而 5/15 在分鐘字段中表示 5,20,35,50,也可以使用*/y,它等同於 0/y;
-
L:只在日期和星期字段中使用,代表“Last”的意思,但它在兩個字段中意思不同。L 在日期字段中,表示這個月份的最後一天,如一月的 31 號,非閏年二月的 28 號;如果 L 用在星期中,則表示星期六,等同於 7。但是,如果 L 出現在星期字段裏,而且在前面有一個數值 X,則表示“這個月的最後 X 天”,例如,6L 表示該月的最後星期五;
-
W:只能出現在日期字段裏,是對前導日期的修飾,表示離該日期最近的工作日。例如 15W表示離該月 15 號最近的工作日,如果該月 15 號是星期六,則匹配 14 號星期五;如果 15 日是星期日,則匹配 16 號星期一;如果 15 號是星期二,那結果就是 15 號星期二。但必須注意關聯的匹配日期不能夠跨月,如你指定 1W,如果 1 號是星期六,結果匹配的是 3 號星期一,而非上個月最後的那天。W 字符串只能指定單一日期,而不能指定日期範圍;
-
LW 組合:在日期字段使用,它的意思是當月的最後一個工作日;
-
井號(#):只能在星期字段中使用,表示當月某個工作日。例如 6#3 表示當月的第三個星期五(6表示星期五,#3 表示當前的第三個),而 4#5 表示當月的第五個星期三,假設當月沒有第五個星期三,忽略不觸發;
-
C:只在日期和星期字段中使用,代表“Calendar”的意思。它的意思是計劃所關聯的日期,如果日期沒有被關聯,則相當於日曆中所有日期。例如 5C 在日期字段中就相當於日曆 5 日以後的第一天。1C 在星期字段中相當於星期日後的第一天;
三、Cron 表達式實例
*/2 * * * * ?
或 0/2 * * * * ?
:每兩秒執行一次
0 0 1 1 * ? *
:每月的1日的凌晨1點執行
0 0 9,12,17 * * ?
:每天上午9點,下午12點,17點執行
0 10 12 * * ?
或 0 10 12 ? * *
或 0 10 12 * * ? *
:每天上午12:10執行
0 30 1 L * ?
:每月最後一日的凌晨1:30執行
0 0 12 ? * WED
:每週三中午12點執行