前言
在做springboot整合Quartz的時候,看到指導手冊裏推薦用cron表達式,然後抱着試試看的態度,額,剛一上手,感覺又回到了正則表達式的恐懼之中,亂,暈,硬着頭皮看,終於看完了,有了一定的理解,趕緊整理記錄下來,方便自己查看,也方便新接觸的同學理解。
正文
1.cron表達式組成
cron表達式用於配置cronTrigger的實例,由七個子表達式組成,表達式之間用空格分隔。
- Seconds(秒)
- Minutes(分)
- Hours(時)
- Day-of-Month(天)
- Month(月)
- Day-of-Week(周)
- Year(年,可選)
2.子表達式範圍
- Seconds(0~59)
- Minutes(0~59)
- Hours(0~23)
- Day-of-Month(1~31,注意:有些月份沒有31天)
- Month(0~11,或者"JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV,DEC")
- Day-of-Week(1~7,或者"SUN, MON, TUE, WED, THU, FRI, SAT")
- Year(1970~2099,可選)
3.子表達式格式
Cron表達式格式:秒 分 時 日 月 周 年(可選)
字段名 | 允許的值 | 允許的特殊字符 |
---|---|---|
秒 | 0-59 | , - * / |
分 | 0-59 | , - * / |
小時 | 0-23 | , - * / |
日 | 1-31 | , - * ? / L W C |
月 | 1-12 or JAN-DEC | , - * / |
周幾 | 1-7 or SUN-SAT | , - * ? / L C # |
年 | empty | 1970-2099 , - * |
4.字符含義
-
* 代表所有可能的值。因此,“*”在Month中表示每個月,在Day-of-Month中表示每天,在Hours表示每小時
-
- 表示指定範圍。
-
, 表示列出枚舉值。例如:在Minutes子表達式中,“5,20”表示在5分鐘和20分鐘觸發。
-
/ 被用於指定增量。例如:在Minutes子表達式中,“0/15”表示從0分鐘開始,每15分鐘執行一次。“3/20"表示從第三分鐘開始,每20分鐘執行一次。和"3,23,43”(表示第3,23,43分鐘觸發)的含義一樣。
-
? 用在Day-of-Month和Day-of-Week中,指“沒有具體的值”。當兩個子表達式其中一個被指定了值以後,爲了避免衝突,需要將另外一個的值設爲“?”。例如:想在每月20日觸發調度,不管20號是星期幾,只能用如下寫法:0 0 0 20 * ?,其中最後以爲只能用“?”,而不能用“*”。
-
L 用在day-of-month和day-of-week字串中。它是單詞“last”的縮寫。它在兩個子表達式中的含義是不同的。在day-of-month中,“L”表示一個月的最後一天,一月31號,3月30號。在day-of-week中,“L”表示一個星期的最後一天,也就是“7”或者“SAT”如果“L”前有具體內容,它就有其他的含義了。例如:“6L”表示這個月的倒數第六天。“FRIL”表示這個月的最後一個星期五。注意:在使用“L”參數時,不要指定列表或者範圍,這樣會出現問題。
-
W “Weekday”的縮寫。只能用在day-of-month字段。用來描敘最接近指定天的工作日(週一到週五)。例如:在day-of-month字段用“15W”指“最接近這個月第15天的工作日”,即如果這個月第15天是週六,那麼觸發器將會在這個月第14天即週五觸發;如果這個月第15天是週日,那麼觸發器將會在這個月第 16天即週一觸發;如果這個月第15天是週二,那麼就在觸發器這天觸發。注意一點:這個用法只會在當前月計算值,不會越過當前月。“W”字符僅能在 day-of-month指明一天,不能是一個範圍或列表。也可以用“LW”來指定這個月的最後一個工作日,即最後一個星期五。
-
# 只能用在day-of-week字段。用來指定這個月的第幾個周幾。例:在day-of-week字段用"6#3" or "FRI#3"指這個月第3個週五(6指週五,3指第3個)。如果指定的日期不存在,觸發器就不會觸發。
-
C 指和calendar聯繫後計算過的值。例:在day-of-month 字段用“5C”指在這個月第5天或之後包括calendar的第一天;在day-of-week字段用“1C”指在這週日或之後包括calendar的第一天。
5.表達式例子
- 0 * * * * ? 每一分鐘觸發一次
- 0 0 * * * ? 每一小時觸發一次
- 0 0 10 * * ? 每10點觸發一次
- 0 * 14 * * ?每天下午2點到2點59分期間,每一分鐘觸發
- 0 30 9 1 * ? 每月一號上午9點30分觸發
- 0 15 10 15 * ?每月15號上午10點15分觸發
- */5 * * * * ? 每隔5秒執行一次
- 0 */1 * * * ? 每隔1分鐘執行一次
- 0 0 5-15 * * ? 每天5-15點整點觸發
- 0 0/3 * * * ? 每三分鐘觸發一次
- 0 0-5 14 * * ? 在每天下午2點到下午2:05期間的每1分鐘觸發
- 0 0/5 14 * * ? 在每天下午2點到下午2:55期間的每5分鐘觸發
- 0 0/5 14,18 * * ? 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發
- 0 0/30 9-17 * * ? 朝九晚五工作時間內每半小時
- 0 0 10,14,16 * * ? 每天上午10點,下午2點,4點
- 0 0 12 ? * WED 表示每個星期三中午12點
- 0 0 17 ? * TUES,THUR,SAT 每週二、四、六下午五點
- 0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44觸發
- 0 15 10 ? * MON-FRI 週一至週五的上午10:15觸發
- 0 0 23 L * ? 每月最後一天23點執行一次
- 0 15 10 L * ? 每月最後一日的上午10:15觸發
- 0 15 10 ? * 6L 每月的最後一個星期五上午10:15觸發
- 0 15 10 * * ? 2005 2005年的每天上午10:15觸發
- 0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最後一個星期五上午10:15觸發
- 0 15 10 ? * 6#3 每月的第三個星期五上午10:15觸發
結束語
cron表達式就整理這麼多吧,其實認真記憶一下符號的含義,再加上程序運行很容易理解,相對正則表達式簡單多了。如果還是不會,那我就推薦一個只需要配置,不需要你寫的神器quartz/Cron/Crontab表達式在線生成工具,這下不用活在恐懼之中了