【Quartz指南】CronTrigger

构造器

CronTrigger(String name, //触发器名称

String group, //触发器的组名

String jobName, //job名称

String jobGroup, //job的组名

Date startTime, //开始时间

Date endTime, //结束时间

String cronExpression, //克隆表达式

TimeZone timeZone)//时区

还有一些其它参数少一些的构造器,参考JavaDoc。通常我们如下简单地使用CronTrigger

Trigger trigger = new CronTrigger(“trigger1″, “group1″);//设置触发器名称和组名

trigger.setCronExpression(“0 0 15 * * ?”);//设置克隆表达式

克隆表达式

一个克隆表达式是一个由空白间隔6个或者7个字段的字符串。

格式:

字段名 必须有? 值范围 允许的特殊字符
Seconds YES 0-59 , – * /
Minutes YES 0-59 , – * /
Hours YES 0-23 , – * /
Day of month YES 1-31 , – * ? / L W C
Month YES 1-12 or JAN-DEC , – * /
Day of week YES 1-7 or SUN-SAT , – * ? / L C #
Year NO empty, 1970-2099 , – * /

例子:

* * * * ? *

0 0/5 14,18,3-39,52 ? JAN,MAR,SEP MON-FRI 2002-2010

特殊字符

  • * 表示所有值 ;
  • ? 表示未说明的值,即不关心它为何值;
  • - 表示一个指定的范围;
  • , 表示附加一个可能值;
  • / 符号前表示开始时间,符号后表示每次递增的值;
  • L (“last”) “L” 用在day-of-month字段意思是 这个月最后一天;用在 day-of-week字段, 它简单意思是 “7” or “SAT”。 如果在day-of-week字段里和数字联合使用,它的意思就是 这个月的最后一个星期几 – 例如: “6L” means 这个月的最后一个星期五. 当我们用“L”时,不指明一个列表值或者范围是很重要的,不然的话,我们会得到一些意想不到的结果。
  • W (“weekday”) –只能用在day-of-month字段。用来描叙最接近指定天的工作日(周一到周五)。例如:在day-of-month字段用“15W”指“最接近这个月第15天的工作日”,即如果这个月第15天是周六,那么触发器将会在这个月第14天即周五触发;如果这个月第15天是周日,那么触发器将会在这个月第16天即周一触发;如果这个月第15天是周二,那么就在触发器这天触发。注意一点:这个用法只会在当前月计算值,不会越过当前月。“W”字符仅能在day-of-month指明一天,不能是一个范围或列表。

也可以用“LW”来指定这个月的最后一个工作日。

  • # -只能用在day-of-week字段。用来指定这个月的第几个周几。例:在day-of-week字段用”6#3″指这个月第3个周五(6指周五,3指第3个)。如果指定的日期不存在,触发器就不会触发。
  • C (“calendar”) – 指和calendar联系后计算过的值。例:在day-of-month 字段用“5C”指在这个月第5天或之后包括calendar的第一天;在day-of-week字段用“1C”指在这周日或之后包括calendar的第一天。

在MONTH和Day of week字段里对字母大小写不敏感。

一些例子

表达式 意思(触发时刻)
0 0 12 * * ? 每天中午12点
0 15 10 * * ? 2005 在2005年的每天10:25
0 10,44 14 ? 3 WED 在3月里每个周三的14:10和14:44
0 15 10 ? * 6L 2002-2005 从2002年到2005年里,每个月的最后一个星期五的10:15
0 0 12 1/5 * ? 从当月的第一天开始,然后在每个月每隔5天的12:00
0 15 10 ? * 6#3 每个月第3个周五的10:15

注意在day-of-week和day-of-month字段里使用“?”和“*”的效果。

注意

  • 对“C”的支持并不很完全。
  • 对在day-of-week字段 和在day-of-month字段同时使用也不是很完全(目前你必须在这两个字段中的一个用“?”指定)。
  • 当设置在午夜和凌晨1点之间触发时要仔细。

不触发指令:

MISFIRE_INSTRUCTION_FIRE_ONCE_NOW

MISFIRE_INSTRUCTION_DO_NOTHING

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » 【Quartz指南】CronTrigger

分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址