一、概述
- 如果您需要一个基于日历类概念(而不是基于SimpleTrigger的精确指定间隔)递归的作业触发计划,那么CronTrigger通常比SimpleTrigger更有用。
- 支持
日历相关的重复时间间隔
(比如每月第一个周一执行),而不是简单的周期时间间隔
- 支持
- 使用CronTrigger,您可以指定休假时间表,如“每周五中午”或“每个工作日和上午9:30”,甚至“一月期间每周一、周三和周五上午9:00到10:00之间每5分钟”。
- 即便如此,与SimpleTrigger一样,CronTrigger也有一个startTime,用于指定计划生效的时间,以及一个(可选的)endTime,用于指定计划应该停止的时间。
调度规则基于 Cron 表达式
二、Cron 表达式
- 格式: [秒] [分] [小时] [日] [月] [周] [年]
- 七个(或者六个)子表达式组成的字符串
- 描述了调度的各个细节
- 这些子表达式用空格隔开
序号 | 说明 | 是否必填 | 允许填写的值 | 允许的通配符 |
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-12"表示"10点到12点"。
- 字符被
- 逗号“
,
”- 字符指定数个值。
- 比如在“周几”字段中设为"MON,WED,FRI"表示"星期一、星期三和星期五"。
- 斜杠“
/
”- 字符用来
指定一个值的的增加幅度
。 - x/y表达一个等步长序列,x为起始值,y为增量步长值。
- 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30,和45秒"。而"5/15"则表示"第5, 20, 35,和50"
- 在’/'前加"*"字符相当于指定从0秒开始。
- */y等同于0/y
- 每个字段都有一系列可以开始或结束的数值。
- 对于“秒”和“分”字段来说,其数值范围为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’字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。
LW
- “L”和“W”可以组合
- 用于“日”字段表示为’LW’,意为"该月最后一个工作日"。
- “
#
”- 字符可用于“周几”字段。
- 该字符表示“
该月第几个周×”
- 比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。
- 再比如: “2#1” =表示该月第一个周一
- 而"4#5" =该月第五个周三。
- 注意如果你指定"#5"该月没有第五个“周×”,该月是不会触发的。
- “
C
”- 字符可用于“日”和“周几”字段,它是"calendar"的缩写。
- 它表示为基于相关的日历所计算出的值(如果有的话)。如果没有关联的日历,那它等同于包含全部日历。
- “日”字段值为"5C"表示"日历中的第一天或者5号以后"
- “周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。
- 对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。
四、常用示例:
- 随便搜索一下
在线Cron表达式生成器
,可以测试一下~- 在线工具-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点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分触发(光棍节) |
0 0 0 */3 * * | 每3天运行一次 |