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 |
周六 |
注意事项
每一个参数都使用数字,但还可以出现如下特殊字符,它们的含义是:
- *:表示匹配该域的任意值。假如在“分”使用“*”,即表示每分钟都会触发事件。
- ?:只能用在“日(每月中的一天)”和“日(每周中的一天)”两个参数中。它也匹配参数的任意值,但实际不会。因为“日(每月中的一天)”和“日(每周中的一天)”会相互影响。例如想在每月的20日触发调度,不管20日是星期几,则只能使用如下写法: 13 13 15 20 * ?,其中最后一位只能用“?”,而不能使用“*”,如果使用“*”表示不管星期几都会触发,实际上并不是这样。
- -:表示范围。例如在“分”使用“5-20”,表示从5分到20分钟每分钟触发一次。
- /:表示起始时间开始触发,然后每隔固定时间触发一次。例如在“分”使用“5/20”,则表示每小时的第5、25、45分钟分别触发定时任务。
- ,:表示列出枚举值。例如:在“分”使用“5,20”,则表示在每小时的5和20分之间,每分钟触发一次定时任务。
- L:表示最后,只能出现在“日(每月中的一天)”和“日(每周中的一天)”参数中。如果在“日(每周中的一天)”域使用“5L”表示在最后的一个星期四触发。
- W:表示有效工作日(周一到周五),只能出现在“日(每月中的一天)”参数中,系统将在离指定日期的最近的有效工作日触发事件。例如:在 “日(每月中的一天)”使用“5W”,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。W的最近寻找不会跨过月份 。
- LW:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。
- #:用于确定每个月第几个星期几,只能出现在“日(每月中的一天)”域。例如在4#2,表示某月的第二个星期三。
示例
以下示例将帮助您更好地理解QuartZ Cron表达式的含义。简单示例展示了QuartZ Cron表达式的初级使用方法。常用示例则展示了QuartZ Cron表达式在实际场景中常见的使用方法,您只需根据实际需求对常用示例进行微调即可将其投入使用。
简单示例:
常用示例: