quartz定时任务时间设置

发表于 | 分类于

quartz.png

文章摘要

Quartz 是一个完全由 Java 编写的开源作业调度框架，为在 Java 应用程序中进行作业调度提供了简单却强大的机制。项目中的定时任务有使用到Quartz，这里就简单记录下其有关概念以及时间设置，方便记忆及以后查看。

Quartz 的核心概念

Job 表示一个工作，要执行的具体内容。此接口中只有一个方法，如下：

1
void execute(JobExecutionContext context)

JobDetail 表示一个具体的可执行的调度程序，Job 是这个可执行程调度程序所要执行的内容，另外 JobDetail 还包含了这个任务调度的方案和策略。

Trigger 代表一个调度参数的配置，什么时候去调。

Scheduler 代表一个调度容器，一个调度容器中可以注册多个 JobDetail 和 Trigger。当 Trigger 与 JobDetail 组合，就可以被 Scheduler 容器调度了。

定时任务时间设置

时间格式: 

1
2
星号： * * * * * * * 
格式： 秒 分 时 日 月 周 年
时间域名 允许填写的值 允许的通配符 是否必填
秒 0-59 , - * / 是
分 0-59 , - * / 是
时 0-23 , - * / 是
周 1-31 , - * ? / L W 是
月 1-12 or JAN-DEC , - * /
周 1-7 or SUN-SAT , - * ? / L # 是
年 1970-2099 , - * / 否

通配符说明：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
'*' 表示所有值。例如:在分的字段上设置'*',表示每一分钟都会触发。

'?' 表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作，但不关心是周几，所以需要周位置的那个字段设置为'?'具体设置为'00010*?'。

'-' 表示区间。例如 在小时上设置'10-12',表示10,11,12点都会触发。','表示指定多个值，例如在周字段上设置'MON,WED,FRI'表示周一，周三和周五触发。

'/' 用于递增触发。如在秒上面设置'5/15'表示从5秒开始，每增15秒触发(5,20,35,50)。在月字段上设置'1/3'所示每月1号开始，每隔三天触发一次。

'L' 表示最后的意思。在日字段设置上，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六，相当于'7'或'SAT'。如果在'L'前加上数字，则表示该数据的最后一个。例如在周字段上设置'6L'这样的格式,则表示"本月最后一个星期五"。

'W' 表示离指定日期的最近那个工作日(周一至周五)。例如在日字段上设置'15W'，表示离每月15号最近的那个工作日触发。如果15号正好是周六，则找最近的周五(14号)触发, 如果15号是周未，则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五)，则就在该天触发。如果指定格式为 '1W',它则表示每月1号往后最近的工作日触发。如果1号正是周六，则将在3号下周一触发。(注，'W'前只能设置具体的数字,不允许区间"-")。

'L'和'W'可以一组合使用。如果在日字段上设置'LW',则表示在本月的最后一个工作日触发(一般指发工资 )序号(表示每月的第几个周几)，例如在周字段上设置'6#3'表示在每月的第三个周六.注意如果指定'#5',正好第五周没有周六，则不会触发该配置(用在母亲节和父亲节再合适不过了)。

周字段的设置，若使用英文字母是不区分大小写的，'MON'与'mon'相同。

常用示例：

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点59分(整点开始，每隔5分触发)
0 0/5 14,18 * * ? 每天下午的 18点到18点59分(整点开始，每隔5分触发)
0 0-5 14 * * ? 每天下午的 2点到2点05分每分触发
0 10,44 14 ? 3 WED 3月分每周三下午的 2点10分和2点44分触发 （特殊情况，在一个时间设置里，执行两次或两次以上的情况）
0 59 2 ? * FRI 每周5凌晨2点59分触发；
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 每月的第三周的星期五开始触发
0 0 12 1/5 * ? 每月的第一个中午开始每隔5天触发一次
0 11 11 11 11 ? 每年的11月11号 11点11分触发(光棍节)

官方文档：http://www.quartz-scheduler.org/documentation/quartz-2.2.x/quick-start.html