定时任务参数配置

QuartZ Cron表达式解析：Cron表达式由7个部分组成，每个部分使用空格隔开。表达式中的七个部分从左到右代表的含义如下：

秒 分 时 日（每月中的一天）月 日（每周中的一天） 年 

 

具体参数如表1 QuartZ Cron参数表所示。

表1 QuartZ Cron参数表

名称	是否必填	可选数值	可选特殊符号
秒	是	数字0-59。	， - * /
分	是	数字0-59。	， - * /
时	是	数字0-23。	， - * /
日（每月中的一天）	是	数字1-31。注意2月没有30日和31日，4月、6月、9月、11月没有31日。	， - * ? / L W C
月	是	数字0-11，或字符串。	， - * /
日（每周中的一天）	是	数字1-7，或字符串。	， - * ? / L C #
年	否	数字1970-2099。	， - * ? / L W C

QuartZ Cron表达式中的月份可以填写数字或者字符串。如果您想在月份参数中填写1月，数字“0”或字符串“JAN”都符合QuartZ Cron表达式的约定。具体数字与字符串如何对应请参考表2 月份数字与字符串对应表。

表2 月份数字与字符串对应表

数字	字符串
0	JAN
1	FEB
2	MAR
3	APR
4	MAY
5	JUN
6	JUL
7	AUG
8	SEP
9	OCT
10	NOV
11	DEC

QuartZ Cron表达式中的日（每周中的一天）可以填写数字或者字符串。如果您想在此参数中填写周一，数字“2”或字符串“MON”都符合QuartZ Cron表达式的约定。具体数字与字符串如何对应请参考表3。QuartZ Cron表达式约定周六为每周的最后一天。

表3 每周数字与字符串对应表

数字	字符串	含义
1	SUN	周日
2	MON	周一
3	TUE	周二
4	WED	周三
5	THU	周四
6	FRI	周五
7	SAT	周六

注意事项

每一个参数都使用数字，但还可以出现如下特殊字符，它们的含义是：

1. *：表示匹配该域的任意值。假如在“分”使用“*”，即表示每分钟都会触发事件。
2. ?：只能用在“日（每月中的一天）”和“日（每周中的一天）”两个参数中。它也匹配参数的任意值，但实际不会。因为“日（每月中的一天）”和“日（每周中的一天）”会相互影响。例如想在每月的20日触发调度，不管20日是星期几，则只能使用如下写法： 13 13 15 20 * ?，其中最后一位只能用“?”，而不能使用“*”，如果使用“*”表示不管星期几都会触发，实际上并不是这样。
3. -：表示范围。例如在“分”使用“5-20”，表示从5分到20分钟每分钟触发一次。
4. /：表示起始时间开始触发，然后每隔固定时间触发一次。例如在“分”使用“5/20”，则表示每小时的第5、25、45分钟分别触发定时任务。
5. ,：表示列出枚举值。例如：在“分”使用“5,20”，则表示在每小时的5和20分之间，每分钟触发一次定时任务。
6. L：表示最后，只能出现在“日（每月中的一天）”和“日（每周中的一天）”参数中。如果在“日（每周中的一天）”域使用“5L”表示在最后的一个星期四触发。
7. W：表示有效工作日(周一到周五)，只能出现在“日（每月中的一天）”参数中，系统将在离指定日期的最近的有效工作日触发事件。例如：在 “日（每月中的一天）”使用“5W”，如果5日是星期六，则将在最近的工作日：星期五，即4日触发。如果5日是星期天，则在6日(周一)触发；如果5日在星期一到星期五中的一天，则就在5日触发。W的最近寻找不会跨过月份 。
8. LW：这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。
9. #：用于确定每个月第几个星期几，只能出现在“日（每月中的一天）”域。例如在4#2，表示某月的第二个星期三。

示例

以下示例将帮助您更好地理解QuartZ Cron表达式的含义。简单示例展示了QuartZ Cron表达式的初级使用方法。常用示例则展示了QuartZ Cron表达式在实际场景中常见的使用方法，您只需根据实际需求对常用示例进行微调即可将其投入使用。

 

简单示例：

0/5 * * * * ? //每隔五秒执行一次
0 0/1 * * * ? //每隔一分钟执行一次
0 0 23 * * ? //每天23点执行一次
0 0 1 1 * ? //每月一号凌晨1点执行一次
0 0 23 L * ? //每月最后一天23点执行一次
0 33,55 * * * ? //在33分，55分执行一次
0 0 18  * * LW //每月最后一个工作日晚上六点执行一次

 

 

常用示例：

0 15 10 * * ? 2019 //2019年的每天上午10:15执行一次。
0 0 12 * * ? //每天中午12点执行一次 。
0 * 14 * * ? //在每天下午2点到下午2:59期间的每1分钟执行一次 。
0 0/30 9-17 * * ? //朝九晚五工作时间内每半小时执行一次。
0 0 12 ? * WED //每个星期三中午12点执行一次。
0 0/30 9-17 * * MON-FRI //周一到周五，早上9点至下午五点期间，每半小时执行一次。
0 15 10 ? * MON-FRI //周一到周五每天上午10:15执行一次。
0 0 2 1 * ? //在每月的1日的凌晨2点调执行一次。
0 15 10 ? * 6#3 //每月的第三个星期五上午10:15执行一次。
0 15 10 ? * 6L //每月的最后一个星期五上午10:15执行一次。
0 30 08 ? 7L 2018-2020 //2018-2020年的每个月的最后一个星期六上午8:30执行一次。
0 15 10 ? 6L 2002-2006 //2002-2006年的每个月的最后一个星期五上午10:15执行一次。