Quartz CronTrigger最完整触发时间配置说明

 

crontrigger

crontrigger配置格式:

格式: [秒] [分] [小时] [日] [月] [周] [年]

序号 说明 是否必填 允许填写的值 允许的通配符
1 0-59 , – * /
2 0-59 , – * /
3 小时 0-23 , – * /
4 1-31 , – * ? / L W
5 1-12 or JAN-DEC , – * /
6 1-7 or SUN-SAT , – * ? / L #
7 empty 或 1970-2099 , – * /

通配符说明:

*表示所有值. 例如:在分的字段上设置 “*”,表示每一分钟都会触发。

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

- 表示区间。例如 在小时上设置 “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 * * ? 每天下午的 2点到2点59分(整点开始,每隔5分触发)

每天下午的 18点到18点59分(整点开始,每隔5分触发)

0 0-5 14 * * ? 每天下午的 2点到2点05分每分触发
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 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分触发(光棍节)

==============================================================================

org.Springframework.scheduling.quartz.crontriggerbean允许你更精确地控制任务的运行时间,只需要设置其cronExpression属性。

一个cronExpression表达式有至少6个(也可能是7个)由空格分隔的时间元素。从左至右,这些元素的定义如下:

1.秒(0–59)

2.分钟(0–59)

3.小时(0–23)

4.月份中的日期(1–31)

5.月份(1–12或JAN–DEC)

6.星期中的日期(1–7或SUN–SAT)

7.年份(1970–2099)

0 0 10,14,16 * * ?

每天上午10点,下午2点和下午4点

0 0,15,30,45 * 1-10 * ?

每月前10天每隔15分钟

30 0 0 1 1 ? 2012

在2012年1月1日午夜过30秒时

0 0 8-5 ? * MON-FRI

每个工作日的工作时间

各个时间可用值如下:

秒0-59 , – * /

分0-59 , – * /

小时0-23 , – * /

日1-31 , – * ? / L W C

月1-12 or JAN-DEC , – * /

周几1-7 or SUN-SAT , – * ? / L C #

年(可选字段) empty, 1970-2099 , – * /

可用值详细分析如下:

“*”——字符可以用于所有字段,在“分”字段中设为”*”表示”每一分钟”的含义。

“?”——字符可以用在“日”和“周几”字段.它用来指定’不明确的值’.这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。

“-”——字符被用来指定一个值的范围,比如在“小时”字段中设为”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,而对于“月”字段来说为1到12。”/”字段仅仅只是帮助你在允许的数值范围内从开始”第n”的值。

“L”——字符可用在“日”和“周几”这两个字段。它是”last”的缩写,但是在这两个字段中有不同的含义。例如,“日”字段中的”L”表示”一个月中的最后一天” ——对于一月就是31号对于二月来说就是28号(非闰年)。而在“周几”字段中,它简单的表示”7″ or “SAT”,但是如果在“周几”字段中使用时跟在某个数字之后,它表示”该月最后一个星期×” ——比如”6L”表示”该月最后一个周五”。当使用’L’选项时,指定确定的列表或者范围非常重要,否则你会被结果搞糊涂的。

“W”——可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五)。比如你将“日”字段设为”15W”,意为: “离该月15号最近的工作日”。因此如果15号为周六,触发器会在14号即周五调用。如果15号为周日,触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为”1W”,而一号又是周六,触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。’W’字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。

“L”和“W”可以组合用于“日”字段表示为’LW’,意为”该月最后一个工作日”。

“#”——字符可用于“周几”字段。该字符表示“该月第几个周×”,比如”6#3″表示该月第三个周五( 6表示周五而”#3″该月第三个)。再比如: “2#1″ =表示该月第一个周一而”4#5” =该月第五个周三。注意如果你指定”#5″该月没有第五个“周×”,该月是不会触发的。

“C”——字符可用于“日”和“周几”字段,它是”calendar“的缩写。它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历,那它等同于包含全部日历。“日”字段值为”5C”表示”日历中的第一天或者5号以后”,“周几”字段值为”1C”则表示”日历中的第一天或者周日以后”。

对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。

一些例子:

“0 0 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和6点至6点55分两个时间段内每5分钟一次触发

“0 0-5 14 * * ?”每天14:00至14:05每分钟一次触发

“0 10,44 14 ? 3 WED”三月的每周三的14:10和14: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

相关阅读

spring Quartz 源码分析–触发器类CronTriggerBean源

前面我们讲到了Quartz框架在项目中的实现,在Quartz中的重要API有两个重要的触发器类:CronTrigger 和SimpleTrigger 在Quartz框

Quartz配置参考

0 前言Quartz的配置通常是使用properties文件结合StdSchedulerFactory完成的。StdSchedulerFactory读取配置文件,并实例化schedule

Quartz与Spring集成—— SchedulerFactoryBean的初始

前言 Quartz是一个开源的定时调度框架,支持集群部署。我们可以通过其Java API来使用它,或者通过Spring来配置与管理,也可以结合使用

发表评论