spring 定時任務 @scheduled(Cron表示式)
Quartz使用類似於Linux下的Cron表示式定義時間規則,Cron表示式由6或7個由空格分隔的時間欄位組成,如表1所示:
表1 Cron表示式時間欄位
位置 | 時間域名 | 允許值 | 允許的特殊字元 |
1 | 秒 | 0-59 | , - * / |
2 | 分鐘 | 0-59 | , - * / |
3 | 小時 | 0-23 | , - * / |
4 | 日期 | 1-31 | , - * ? / L W C |
5 | 月份 | 1-12 | , - * / |
6 | 星期 | 1-7 | , - * ? / L C # |
7 | 年(可選) | 空值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組合:在日期欄位可以組合使用LW,它的意思是當月的最後一個工作日;
●井號(#):該字元只能在星期欄位中使用,表示當月某個工作日。如6#3表示當月的第三個星期五(6表示星期五,#3表示當前的第三個),而4#5表示當月的第五個星期三,假設當月沒有第五個星期三,忽略不觸發;
● C:該字元只在日期和星期欄位中使用,代表“Calendar”的意思。它的意思是計劃所關聯的日期,如果日期沒有被關聯,則相當於日曆中所有日期。例如5C在日期欄位中就相當於日曆5日以後的第一天。1C在星期欄位中相當於星期日後的第一天。
Cron表示式對特殊字元的大小寫不敏感,對代表星期的縮寫英文大小寫也不敏感。
表2下面給出一些完整的Cron表示式的例項:
表2 Cron表示式示例
表示式 | 說明 |
"0 0 12 * * ? " | 每天12點執行 |
"0 15 10 ? * *" | 每天10:15執行 |
"0 15 10 * * ?" | 每天10:15執行 |
"0 15 10 * * ? *" | 每天10:15執行 |
"0 15 10 * * ? 2008" | 在2008年的每天10:15執行 |
"0 * 14 * * ?" | 每天14點到15點之間每分鐘執行一次,開始於14:00,結束於14:59。 |
"0 0/5 14 * * ?" | 每天14點到15點每5分鐘執行一次,開始於14:00,結束於14:55。 |
"0 0/5 14,18 * * ?" | 每天14點到15點每5分鐘執行一次,此外每天18點到19點每5鍾也執行一次。 |
"0 0-5 14 * * ?" | 每天14:00點到14:05,每分鐘執行一次。 |
"0 10,44 14 ? 3 WED" | 3月每週三的14:10分到14: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 2007-2009" | 在2007,2008,2009年每個月的最後一個星期五的10:15分執行。 |
"0 15 10 ? * 6#3" | 每月第三個星期五的10:15分執行。 |