Springboot(-) Quartz定時任務cron表達式詳解

前言

在做springboot整合Quartz的時候,看到指導手冊裏推薦用cron表達式,然後抱着試試看的態度,額,剛一上手,感覺又回到了正則表達式的恐懼之中,亂,暈,硬着頭皮看,終於看完了,有了一定的理解,趕緊整理記錄下來,方便自己查看,也方便新接觸的同學理解。

正文

1.cron表達式組成

cron表達式用於配置cronTrigger的實例,由七個子表達式組成,表達式之間用空格分隔。

  1. Seconds(秒)
  2. Minutes(分)
  3. Hours(時)
  4. Day-of-Month(天)
  5. Month(月)
  6. Day-of-Week(周)
  7. Year(年,可選)

2.子表達式範圍

  1. Seconds(0~59)
  2. Minutes(0~59)
  3. Hours(0~23)
  4. Day-of-Month(1~31,注意:有些月份沒有31天)
  5. Month(0~11,或者"JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV,DEC")
  6. Day-of-Week(1~7,或者"SUN, MON, TUE, WED, THU, FRI, SAT")
  7. 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表達式在線生成工具,這下不用活在恐懼之中了

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章