概述

CronTrigger 比 SimpleTrigger 更有用，如果你需要基于日期的概念来触发任务的话，可以使用 CronTrigger。

使用 CronTrigger，你可以指定以下的这些日期：“每周五中午”，或“每天上午 9:30”，或者“每周一上午 9:00 到 10:00 每 5 分钟，一月的每个周四和周五”。

虽然如此，就像 SimpleTrigger 一样，CronTrigger 也可以设置 startTime 和 endTime。

---

Cron表达式的组成

Cron 表达式用于配置 CornTrigger 实例。Cron 表达式是一个字符串，由 7 个子表达式组成，这 7 个部分用空格分隔，它们分别表示：

1. 秒
2. 分钟
3. 小时
4. 日
5. 月份
6. 星期几
7. 年（可选字段）

Cron Schedule用的了Cron表达式**【秒】【分】【时】【日】【月】【周】【年】**

例如，Cron 表达式 “0 0 12 ? * WED” 表示“每周三下午 12:00:00”。

---

cron表达式中的问号(?) 的含义

问号(?)的作用是指明该字段‘没有特定的值’

其实这也很好理解，比如：“0/5 * * 3 * SUN”，既指定了每个月的3号，并且又指定了每个星期天，那么并不可能存在每个3号都是星期天的可能性，所以，表达式也就不成立了。

cronExpression对日期和星期字段的处理规则是它们必须互斥，即只能且必须有一个字段有特定的值，另一个字段必须是‘没有特定的值’；

1、当星期和日期都为*或数字时，报错

Support for specifying both a day-of-week AND a day-of-month parameter is not implemented.

即两个字段不能都指明的特定的值，必须互斥。这里的*和数字是一样的，如果都指明特定的数字，也是报一样的错。

2、当星期和日期都为?时，报错

'?' can only be specfied for Day-of-Month -OR- Day-of-Week.

即两个字段不能都‘没有特定的值’。

---

时间格式

---

特殊字符

特殊字符	含义
*	字符可以用于所有字段，在“分”字段中设为"*"表示"每一分钟"的含义
?	字符可以用在“日”和“周几”字段. 它用来指定 ‘不明确的值’. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到
-	字符被用来指定一个值的范围，比如在“小时”字段中设为"10-12"表示"10点到12点"
,	字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday"
/	字符用来指定一个值的的增加幅度，比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 “5/15"则表示"第5, 20, 35, 和 50”. 在’/'前加"*“字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说，其数值范围为0到59，对于“小时”字段来说其为0到23, 对于“日”字段来说为0到31, 而对于“月”字段来说为0到11。”/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。 因此对于“月”字段来说"7/6"只是表示7月被开启而不是“每六个月”, 请注意其中微妙的差别
L	字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号（非闰年）。而在“周几”字段中, 它简单的表示"7" or “SAT”，但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用’L’选项时,指定确定的列表或者范围非常重要，否则你会被结果搞糊涂的
W	可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W"，意为: “离该月15号最近的工作日”。因此如果15号为周六，触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W’字符只能用于“日”字段的值为单独的一天而不是一系列值的时候
LW	可以组合用于“日”字段表示为’LW’，意为"该月最后一个工作日"
#	字符可用于“周几”字段。该字符表示“该月第几个周×”，比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: “2#1” = 表示该月第一个周一而 “4#5” = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”，该月是不会触发的
C	字符可用于“日”和“周几”字段，它是"calendar"的缩写。它表示为基于相关的日历所计算出的值（如果有的话）。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后"，“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"

---

Cron 表达式样例

CronTrigger 样例 1 – 时钟从 0 分钟开始，每 5 分钟执行一次

0 0/5 * * * ?

---

CronTrigger 样例 2 – 时钟从 0 分钟开始，每 5 分钟执行一次，并且秒钟是 10（例如 10:00:10 am， 10:05:10 am 等）

10 0/5 * * * ?

CronTrigger 样例 3 – 每个周三和周五的 10:30， 11:30， 12:30 和 13:30 执行一次

0 30 10-13 ? * WED,FRI

CronTrigger 样例 4 – 每个月 5 日到 20 日，早上 8 点 到 10 点，时钟从 0 开始，每半小时执行一次。注意，不会在上午 10:00 执行，只会在 8:00， 8:30， 9:00 和 9:30 执行。

0 0/30 8-9 5,20 * ?

注意，有的时候使用一个单独的 Trigger 来执行任务将会很复杂，例如“早上 9 点到早上 10 点，每 5 分钟执行一次，下午 1 点到下午 10 点，每 20 分钟执行一次”。这样的话，你可以创建两个 Trigger，并且让两个 Trigger 都关联到同一个 Job。

---

---

创建 CronTrigger

可以使用 TriggerBuilder 来创建 CronTrigger（基于 Trigger 的主要属性），或使用 CronScheduleBuilder 来创建 CronTrigger（基于 CronTrigger 特殊属性）为了使用 DSL 风格，需要进行静态导入：

import static org.quartz.TriggerBuilder.*;
import static org.quartz.CronScheduleBuilder.*;
import static org.quartz.DateBuilder.*:

---

创建一个 Trigger，并且在每天的上午 8 点到下午 5 点，每隔 1 分钟执行一次：

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 0/2 8-17 * * ?")).forJob("myJob", "group1").build();

---

创建一个 Trigger，并且在每天的上午 10:42 执行一次：

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(dailyAtHourAndMinute(10, 42)).forJob(myJobKey).build();

或

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 42 10 * * ?")).forJob(myJobKey).build();

---

创建一个 Trigger，并在每周三上午 10:42 执行，使用设置的时区而非系统默认时区：

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(weeklyOnDayAndHourAndMinute(DateBuilder.WEDNESDAY, 10, 42)).forJob(myJobKey).inTimeZone(TimeZone.getTimeZone("America/Los_Angeles")).build();

或

trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 42 10 ? * WED")).inTimeZone(TimeZone.getTimeZone("America/Los_Angeles")).forJob(myJobKey).build();

---

CronTrigger 错过触发机制

下面的策略将通知 Quartz 如果发生了错过触发将会如何处理（关于错过触发的概念可参看 Triggers 详解）。这些机制以常量形式定义在 CronTrigger 类中（JavaDoc 中详细描述了它们各自的行为）。

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY
MISFIRE_INSTRUCTION_DO_NOTHING
MISFIRE_INSTRUCTION_FIRE_NOW

所有 Trigger 的默认总是使用 Trigger.MISFIRE_INSTRUCTION_SMART_POLICY （智能策略）。对于 CronTrigger 来说，只能策略就是 MISFIRE_INSTRUCTION_FIRE_NOW。CronTrigger.updateAfterMisfire() 方法的 JavaDoc 详细解释了这个行为的细节。

当创建 CronTrigger 的时候，可以通过 CronSchedulerBuilder 指定错过触发机制：

  trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 0/2 8-17 * * ?").withMisfireHandlingInstructionFireAndProceed()).forJob("myJob", "group1").build();

---

Cron表达式生成器在线网站

http://www.pdtools.net/tools/becron.jsp

http://cron.qqe2.com/

示例

package com.xgj.quartz.quartzItself.cronTriggerDemo;import static org.quartz.CronScheduleBuilder.cronSchedule;
import static org.quartz.JobBuilder.newJob;
import static org.quartz.TriggerBuilder.newTrigger;import java.util.Date;import org.apache.log4j.Logger;
import org.quartz.CronTrigger;
import org.quartz.JobDetail;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.SchedulerMetaData;
import org.quartz.impl.StdSchedulerFactory;/*** * * @ClassName: CronTriggerExample* * @Description: This Example will demonstrate all of the basics of scheduling*               capabilities of Quartz using Cron Triggers.* * @author: Mr.Yang* * @date: 2017年10月7日 下午10:46:05*/
public class CronTriggerExample {public void run() throws Exception {Logger log = Logger.getLogger(CronTriggerExample.class);log.info("------- Initializing -------------------");// First we must get a reference to a schedulerSchedulerFactory sf = new StdSchedulerFactory();Scheduler sched = sf.getScheduler();log.info("------- Initialization Complete --------");log.info("------- Scheduling Jobs ----------------");// jobs can be scheduled before sched.start() has been called// job 1 will run every 20 secondsJobDetail job = newJob(SimpleJob.class).withIdentity("job1", "group1").build();CronTrigger trigger = newTrigger().withIdentity("trigger1", "group1").withSchedule(cronSchedule("0/20 * * * * ?")).build();Date ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());// job 2 will run every other minute (at 15 seconds past the minute)job = newJob(SimpleJob.class).withIdentity("job2", "group1").build();trigger = newTrigger().withIdentity("trigger2", "group1").withSchedule(cronSchedule("15 0/2 * * * ?")).build();ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());// job 3 will run every other minute but only between 8am and 5pmjob = newJob(SimpleJob.class).withIdentity("job3", "group1").build();trigger = newTrigger().withIdentity("trigger3", "group1").withSchedule(cronSchedule("0 0/2 8-17 * * ?")).build();ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());// job 4 will run every three minutes but only between 5pm and 11pmjob = newJob(SimpleJob.class).withIdentity("job4", "group1").build();trigger = newTrigger().withIdentity("trigger4", "group1").withSchedule(cronSchedule("0 0/3 17-23 * * ?")).build();ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());// job 5 will run at 10am on the 1st and 15th days of the monthjob = newJob(SimpleJob.class).withIdentity("job5", "group1").build();trigger = newTrigger().withIdentity("trigger5", "group1").withSchedule(cronSchedule("0 0 10am 1,15 * ?")).build();ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());// job 6 will run every 30 seconds but only on Weekdays (Monday through// Friday)job = newJob(SimpleJob.class).withIdentity("job6", "group1").build();trigger = newTrigger().withIdentity("trigger6", "group1").withSchedule(cronSchedule("0,30 * * ? * MON-FRI")).build();ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());// job 7 will run every 30 seconds but only on Weekends (Saturday and// Sunday)job = newJob(SimpleJob.class).withIdentity("job7", "group1").build();trigger = newTrigger().withIdentity("trigger7", "group1").withSchedule(cronSchedule("0,30 * * ? * SAT,SUN")).build();ft = sched.scheduleJob(job, trigger);log.info(job.getKey() + " has been scheduled to run at: " + ft+ " and repeat based on expression: "+ trigger.getCronExpression());log.info("------- Starting Scheduler ----------------");// All of the jobs have been added to the scheduler, but none of the// jobs// will run until the scheduler has been startedsched.start();log.info("------- Started Scheduler -----------------");log.info("------- Waiting five minutes... ------------");try {// wait five minutes to show jobsThread.sleep(300L * 1000L);// executing...} catch (Exception e) {//}log.info("------- Shutting Down ---------------------");sched.shutdown(true);log.info("------- Shutdown Complete -----------------");SchedulerMetaData metaData = sched.getMetaData();log.info("Executed " + metaData.getNumberOfJobsExecuted() + " jobs.");}public static void main(String[] args) throws Exception {CronTriggerExample example = new CronTriggerExample();example.run();}
}

/* * All content copyright Terracotta, Inc., unless otherwise indicated. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy * of the License at * *   http://www.apache.org/licenses/LICENSE-2.0 *   * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License.* */package com.xgj.quartz.quartzItself.cronTriggerDemo;import java.util.Date;import org.apache.log4j.Logger;
import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.quartz.JobKey;/*** <p>* This is just a simple job that gets fired off many times by example 1* </p>* */
public class SimpleJob implements Job {private static Logger _log = Logger.getLogger(SimpleJob.class);/*** Quartz requires a public empty constructor so that the* scheduler can instantiate the class whenever it needs.*/public SimpleJob() {}/*** <p>* Called by the <code>{@link org.quartz.Scheduler}</code> when a* <code>{@link org.quartz.Trigger}</code> fires that is associated with* the <code>Job</code>.* </p>* * @throws JobExecutionException*             if there is an exception while executing the job.*/public void execute(JobExecutionContext context)throws JobExecutionException {// This job simply prints out its job name and the// date and time that it is runningJobKey jobKey = context.getJobDetail().getKey();_log.info("SimpleJob says: " + jobKey + " executing at " + new Date());}}

---

示例源码

代码已托管到Github—> https://github.com/yangshangwei/SpringMaster

Quartz-CronTrigger解读相关推荐

1. org.quartz.CronTrigger cannot be cast to org.springframework.scheduling.quartz.CronTriggerBean

   问题:org.quartz.CronTrigger cannot be cast to org.springframework.scheduling.quartz.CronTriggerBean 分析 ...

2. scheduling.quartz.CronTriggerBean has interface org.quartz.CronTrigger as super class

   转自:https://blog.csdn.net/lzj0470/article/details/17786587 quartz版本号:2.1.7 错误: 1 Caused by: <a hre ...

3. Quartz CronTrigger时间最完整配置说明

   CronTrigger配置格式: 格式: [秒] [分] [小时] [日] [月] [周] [年]  序号 说明  是否必填  允许填写的值 允许的通配符  1  秒  是  0-59    , - ...

4. springboot整合Quartz实现动态配置定时任务

   版权声明:本文为博主原创文章,转载请注明出处. https://blog.csdn.net/liuchuanhong1/article/details/60873295 前言 在我们日常的开发中,很多 ...

5. java timer cron_Java之旅--定时任务(Timer、Quartz、Spring、LinuxCron)

   在Java中,实现定时任务有多种方式.本文介绍4种.Timer和TimerTask.Spring.QuartZ.Linux Cron. 以上4种实现定时任务的方式.Timer是最简单的.不须要不论什么 ...

6. 时区切换导致quartz定时任务没有触发问题

   时区切换对Quartz的cron表达式有影响,切换的1小时内停止触发定时任务,导致sla没有定时清空内存计数,误发限流. 美国夏令时PST切换到冬令时PDT,会有时间跳变.不带时区跳变的,会出现时间重 ...

7. Java任务调度框架Quartz

   转自:http://blog.csdn.net/yuebinghaoyuan/article/details/9045471 介绍 Quartz is a full-featured, open so ...

8. Spring Boot集成持久化Quartz定时任务管理

   2019独角兽企业重金招聘Python工程师标准>>> 首先在项目pom.xml中添加Quartz依赖 <dependency><groupId>org.qu ...

9. quartz mysql 初始化_quartz2.3.0（十五）执行、暂停、继续执行、清除，花式操作数据库中持久化的job任务...

   前提准备: 先在数据库中建立quartz需要的11张表(我这里用的是Oracle数据库),根据不同的数据库quartz分别提供了不同的初始化sql文件,sql文件路径在 quartz-2.3.0-SN ...

10. Quartz 在 Spring 中如何动态配置时间

    在项目中有一个需求,需要灵活配置调度任务时间,并能自由启动或停止调度. 有关调度的实现我就第一就想到了Quartz这个开源调度组件,因为很多项目使用过,Spring结合Quartz静态配置调度任务时间 ...

最新文章

1. 2010年10月VB100测试成绩
2. SQL Server查询性能优化——堆表、碎片与索引（一）
3. 如何自学python a byte to python-你是如何自学 Python 的？
4. 使用gnucash查看任意时间段内的所有者权益变动表
5. 如何把a1的图纸变成a0_如何安装家用空开配电
6. 数字化平台之微信平台策略
7. python web.py 404_找不到web.py开发服务器-favicon.ico-404
8. Codeforces 773D Perishable Roads 最短路 （看题解）
9. 【转】解密Qt安装目录的结构
10. 你们学习前端都是靠自学吗？
11. javascript焦点图自动播放
12. FM1208CPU卡读写函数说明
13. c语言无法打开源文件stdafx.h,VS2013/2012/2010 下无法打开 源 文件“stdafx.h”的解决方法...
14. datax(3): win环境cmd乱码
15. 时序报告要看哪些指标
16. CSS 3.0实现八卦图
17. error: warning: Stopped in a context claiming to capture an Objective-C object pointer,
18. linux seek原理,Linux内核：seek机制
19. python 模拟百度搜索关键词
20. 深度对比：电子合同与纸质合同到底有哪些差异？

热门文章

1. android 动画停止播放,Android动画暂停和播放问题
2. 小米笔记本电脑启动失败
3. java权限管理面试_java shiro面试题
4. WiFi PowerSave模式以及通过抓包判断是否生效
5. Http接口开发以及异常调试
6. KinhDown(度盘PC下载器)
7. ios实现读写锁,AFN的实现
8. OSAL工作机制分析
9. Java数据持久层框架
10. TIA博途中如何设置不需要初始化DB块也可以下载？