一個cron表達式有至少6個(也可能7個)有空格分隔的時間元素。
一、按順序依次為:
- 秒 (0~59)
- 分鐘 (0~59)
- 小時 (0~23)
- 天 (0~31,但是你需要考慮你月的天數)
- 月 (0~11)
- 天 (星期 (1~7 1=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT)
- 年份 (1970-2099)
二、格式如下
字段 | 允許值 | 允許的特殊字元 |
---|---|---|
秒 | 0-59 | , - * / |
分 | 0-59 | , - * / |
小時 | 0-23 | , - * / |
日期 | 1-31 | , - * ? / L W C |
月份 | 1-12 或者 JAN-DEC | , - * / |
星期 | 1-7 或者 SUN-SAT | , - * ? / L C # |
年(可選) | 留白, 1970-2099 | , - * / |
三、其中每個元素可以是
- 一個值(如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觸發
五、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組合:在日期字段可以組合使用LW,它的意思是當月的最後一個工作日;
- #:該字元隻能在星期字段中使用,表示當月某個工作日。如6#3表示當月的第三個星期五(6表示星期五,#3表示目前的第三個),而4#5表示當月的第五個星期三,假設當月沒有第五個星期三,忽略不觸發;
- C:該字元隻在日期和星期字段中使用,代表“Calendar”的意思。它的意思是計劃所關聯的日期,如果日期沒有被關聯,則相當于月曆中所有日期。例如5C在日期字段中就相當于月曆5日以後的第一天。1C在星期字段中相當于星期日後的第一天。