一. 域說明
cron表達式由6或7個域組成
| 順序(從左到右) | 域 | 允許值 | 允許的特殊字符 |
|---|---|---|---|
| 1 | 秒（Seconds） | 0~59的整數 | , - * /（四個字符） |
| 2 | 分（Minutes） | 0~59的整數 | , - * /（四個字符） |
| 3 | 小時（Hours） | 0~23的整數 | , - * /（四個字符） |
| 4 | 日期（DayofMonth） | 1~31的整數（但是你需要考慮你月的天數） | ,- * ? / L W C（八個字符） |
| 5 | 月份（Month） | 1~12的整數 或 JAN-DEC數 | , - * /（四個字符） |
| 6 | 星期（DayofWeek） | 1~7的整數或者 SUN-SAT （1=SUN） | ,- * ? / L W C（八個字符） |
| 7 | 年(可選，留空)（Year） | 1970~2099 | , - * /（四個字符） |
二. 特殊字符說明
1 * 表示匹配該域的任意值。假如在Minutes域使用, 即表示每分鐘都會觸發事件
2 ? 只能在DayofMonth和DayofWeek兩個域使用。但DayofMonth和DayofWeek會相互影響，例如想在每月的20日觸發調度，不管20日到底是星期幾，則只能使用如下寫法： 13 13 15 20 * ?, 其中最後一位只能用？，如果使用則表示不管星期幾都會觸發
3 - 表示範圍。例如在Minutes域使用5-20，表示從5分到20分鐘每分鐘觸發一次
4 / 表示起始時間開始觸發，然後每隔固定時間觸發一次。例如在Minutes域使用5/20,則意味着第5分鐘觸發一次，而25，45等分別觸發一次
5 , 表示列出枚舉值。例如：在Minutes域使用5,20，則意味着在5和20分每分鐘觸發一次
6 L 表示最後，只能出現在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最後的一個星期四觸發
7 W 表示有效工作日(週一到週五),只能出現在DayofMonth域，系統將在離指定日期的最近的有效工作日觸發事件。例如：在 DayofMonth使用5W，如果5日是星期六，則將在最近的工作日：星期五，即4日觸發。如果5日是星期天，則在6日(週一)觸發；如果5日在星期一到星期五中的一天，則在5日觸發。另外一點，W的最近尋找不會跨月
8 LW 這兩個字符可以連用，表示在某個月最後一個工作日，即最後一個星期五
9 # 用於確定每個月第幾個星期幾，只能出現在DayofMonth域。例如在4#2，表示某月的第二個星期三
三. 常用例子
- 0 0 2 1 * ? * ( 表示在每月的1日的凌晨2點調整任務 )
- 0 15 10 ? * MON-FRI ( 表示週一到週五每天上午10:15執行作業 )
- 0 15 10 ? 6L 2002-2006 ( 表示2002-2006年的每個月的最後一個星期五上午10:15執行 )
- 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觸發 )
四. 注意事項
1. 有些表達式能包含範圍或列表
例如：表達式（星期幾）可以爲 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”
“*”字符代表所有可能的值。因此，“*”在表達式（月）裏表示每個月的含義，“*”在表達式（星期幾）表示星期的每一天
2. “/”字符用來指定數值的增量
例如：在表達式（分鐘）裏的“0/15”表示從第0分鐘開始，每15分鐘執行一次
在表達式（分鐘）裏的“3/20”表示從第3分鐘開始，每20分鐘（它和“3，23，43”）執行一次
3. “？”字符僅被用於每月第幾天和星期幾兩個表達式，表示不指定值
當2個子表達式其中之一被指定了值以後，爲了避免衝突，需要將另一個子表達式的值設爲“？”
4. “L” 字符僅被用於 每月第幾天 和 星期幾 兩個表達式，它是單詞“last”的縮寫
但是它在兩個表達式裏的含義是不同的。
在 每月第幾天 表達式中，“L”表示一個月的最後一天
在 星期幾 表達式中，“L”表示一個星期的最後一天，也就是SAT
如果在“L”前有具體的內容，它就具有其它的含義了
例如：“6L”表示這個月的倒數第6天，“FRIL”表示這個月的最後一個星期五
注意：在使用“L”參數時，不要指定列表或範圍，因爲這會導致問題
5. 報錯：Cron expression must consist of 6 fields
spring 3.0 後只支持 “6個參數”的cron，可去掉年份字段
五. Java解析Cron表達式
import org.springframework.scheduling.support.CronSequenceGenerator;
@Test
public void getExecuteTime() {
String cron = "";
int size = 10;
// 每月1號執行
cron = "0 0 0 1 1/1 ?";
CronSequenceGenerator g = new CronSequenceGenerator(cron);
Date d = new Date();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
List<String> res = new ArrayList<>(size);
for (int i = 0; i < size; i++) {
d = g.next(d);
res.add(sdf.format(d));
}
res.forEach(System.out::println);
}