Quartz任务调度(2)CronTrigger定制个性化调度方案

Cron表达式

1. 时间字段与基本格式

Cron表达式有6或7个空格分割的时间字段组成:

位置 时间域名 允许值 允许的特殊字符
1 0-59 ,-*/
2 分支 0-59 ,-*?/
3 小时 0-23 ,-*/
4 日期 1-31 ,-*/LWC
5 月份 1-12或 JAN-DEC ,-*/
6 星期 1-7 或 SUN-SAT ,-*?/LC#
7 年(可选) 1970-2099 ,-*/

在月份和星期中,我们也可以使用英文单词的缩写形式

2. 特殊字符

在Cron表达式的时间字段中,除允许设置数值外,还能你使用一些特殊的字符,提供列表、范围、通配符等功能

1. 星号(*)

可用在所有字段下,表示对应时间域名的每一个时刻,如*用在分钟字段,表示“每分钟”。

2. 问号(?)

只能用在日期和星期字段,代表无意义的值,比如使用L设定为当月的最后一天,则配置日期配置就没有意义了,可用?作占位符的作用。

3. 减号(-)

表示一个范围,如在日期字段5-10,表示从五号到10号,相当于使用逗号的5,6,7,8,9,10

4. 逗号(,)

表示一个并列有效值,比如在月份字段使用JAN,DEC表示1月和12月

5. 斜杠(/)

x/y表示一个等步长序列,x为起始值,y为增量步长值,如在小时使用1/3相当于1,4,7,10当时用*/y时,相当于0/y

6. L

L(Last)只能在日期和星期字段使用,但意思不同。在日期字段,表示当月最后一天,在星期字段,表示星期六(如果按星期天为一星期的第一天的概念,星期六就是最后一天。如果L在星期字段,且前面有一个整数值X,表示“这个月的最后一个星期X”,比如3L表示某个月的最后一个星期二

7. W

选择离给定日期最近的工作日(周一至周五)。例如你指定“15W”作为day of month字段的值,就意味着“每个月与15号最近的工作日”。所以,如果15号是周六,则触发器会在14号(周五)触发。如果15号是周日,则触发器会在16号(周一)触发。如果15号是周二,则触发器会在15号(周二)触发。但是,如果你指定“1W”作为day of month字段的值,且1号是周六,则触发器会在3号(周一)触发。quartz不会“跳出”月份的界限。

8. LW组合

在日期字段可以组合使用LW,表示当月最后一个工作日(周一至周五)

9. 井号(#)

只能在星期字段中使用指定每月第几个星期X。例如day of week字段的“6#3”,就意味着“每月第3个星期五”(day3=星期五,#3=第三个);“2#1”就意味着“每月第1个星期一”;“4#5”就意味着“每月第5个星期3。需要注意的是“#5”,如果在当月没有第5个星期三,则触发器不会触发。

10. C

只能在日期和星期字段中使用,表示计划所关联的诶其,如果日期没有被关联,相当于日历中的所有日期,如5C在日期字段相当于5号之后的第一天,1C在日期字段使用相当于星期填后的第一天

3. 一些实例

Cron表达式对特殊字符的大小写不敏感,对代表星期的缩写英文大小写也不敏感。如MON和mon是一样的

cron表达式 含义
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分,每分钟触发一次
0 0/5 14 * * ? 每天的2点整至2点55分,每5分钟触发一次
0 0/5 14,18 * * ? 每天的2点整至2点55分以及18点整至18点55分,每5分钟触发一次
0 0-5 14 * * ? 每天的2点整至2点5分,每分钟触发一次
0 10,44 14 ? 3 WED 每年3月的每个星期三的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 每月最后一个周五的10点15分触发一次
0 15 10 ? * 6L 2002-2005 2002年至2005年间,每月最后一个周五的10点15分触发一次
0 15 10 ? * 6#3 每月第三个周五的10点15触发一次
0 0 12 1/5 * ? 每月1号开始,每5天的12点整触发一次
0 11 11 11 11 ? 每年11月11日11点11分触发一次

使用示例

在quartz1.+版本中,我们通过如下方法创建CronTrigger

//定义调度触发规则,每天上午10:15执行  
CronTrigger cornTrigger=new CronTrigger("cronTrigger","triggerGroup");  
//执行规则表达式  
cornTrigger.setCronExpression("0 15 10 * * ? *");

而在2.+版本中,则通过如下方式创建

//使用cornTrigger规则  每天10点42分  
Trigger trigger=TriggerBuilder.newTrigger().withIdentity("simpleTrigger", "triggerGroup")  
    .withSchedule(CronScheduleBuilder.cronSchedule("0 42 10 * * ? *"))  
    .startNow().build();
上一篇:Spring Boot笔记(三) springboot 集成 Quartz 定时任务


下一篇:Quartz使用