cron 表达式格式和各占位符解释:
{秒数} {分钟} {小时} {日期} {月份} {星期} {年份(可为空)}
{秒数} {分钟}
允许值范围: 0~59
,不允许为空值,若值不合法,调度器将抛出SchedulerException
异常
{小时}
允许值范围: 0~23
,不允许为空值,若值不合法,调度器将抛出SchedulerException
异常,占位符和秒数一样
{日期}
允许值范围: 1~31
,不允许为空值,若值不合法,调度器将抛出 SchedulerException
异常
{星期}
允许值范围: 1~7
(SUN-SAT
), 1
代表星期天(一星期的第一天),以此类推,7
代表星期六(一星期的最后一天),不允许为空值,若值不合法,调度器将抛出SchedulerException
异常
{年份}
允许值范围: 1970~2099
,允许为空,若值不合法,调度器将抛出SchedulerException
异常
注意:除了
{日期}
和{星期}
可以使用?
来实现互斥,表达无意义的信息之外,其他占位符都要具有具体的时间含义,且依赖关系为:年->月->日期(星期)->小时->分钟->秒数
{Seconds} {Minutes} {Hours} {DayofMonth} {Month} {DayofWeek} {Year}
每一个域可出现的字符如下:
Seconds
: 可出现”, - * /
“四个字符,有效范围为0-59
的整数
Minutes
: 可出现”, - * /
“四个字符,有效范围为0-59
的整数
Hours
: 可出现”, - * /
“四个字符,有效范围为0-23
的整数
DayofMonth
:可出现”, - * / ? L W C
“八个字符,有效范围为0-31
的整数
Month
: 可出现”, - * /
“四个字符,有效范围为1-12
的整数或JAN-DEC
DayofWeek
: 可出现”, - * / ? L C #
“字符,有效范围为1-7
的整数或SUN-SAT
两个范围。1
表示星期天,2
表示星期一, 依次类推
Year
: 可出现”, - * /
“四个字符,有效范围为1970-2099
年
每一个域都使用数字,但还可以出现如下特殊字符,它们的含义是:
(1) *
:表示匹配该域的任意值,假如在Minutes域使用*
, 即表示每分钟都会触发事件。
(2) ?
:只能用在DayofMonth和DayofWeek两个域。它也匹配域的任意值,但实际不会。因为 DayofMonth 和 DayofWeek 会相互影响。例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ?
, 其中最后一位只能用?
,而不能使用*
,如果使用*
表示不管星期几都会触发,实际上并不是这样。
(3) -
:表示范围,例如在Minutes域使用5-20
,表示从5分到20分钟每分钟触发一次
(4) /
:表示起始时间开始触发,然后每隔固定时间触发一次,例如在Minutes域使用5/20
,则意味着5分钟触发一次,而25,45等分别触发一次
(5) ,
:表示列出枚举值值。例如:在Minutes域使用5,20
,则意味着在5和20分每分钟触发一次。
(6) L
:表示最后,只能出现在DayofWeek和DayofMonth域,如果在DayofWeek域使用5L
,意味着在最后的一个星期四触发。
(7) W
:表示有效工作日(周一到周五),只能出现在DayofMonth域,系统将在离指定日期的最近的有效工作日触发事件。例如:在 DayofMonth使用5W
,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一 到星期五中的一天,则就在5日触发。另外一点,W
的最近寻找不会跨过月份。
(8) LW
:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。
(9) #
:用于确定每个月第几个星期几,只能出现在DayofMonth域。例如在4#2
,表示某月的第二个星期三。
例子
cron表达式的强大魅力在于灵活的横向和纵向组合以及简单的语法,用cron表达式几乎可以写出任何你想要触发的时间点与周期
经典案例:
-
30 * * * * ?
每半分钟触发任务 -
30 10 * * * ?
每小时的10分30秒触发任务 -
30 10 1 * * ?
每天1点10分30秒触发任务 -
30 10 1 20 * ?
每月20号1点10分30秒触发任务 -
30 10 1 20 10 ? *
每年10月20号1点10分30秒触发任务 -
30 10 1 20 10 ? 2011
2011年10月20号1点10分30秒触发任务 -
30 10 1 ? 10 * 2011
2011年10月每天1点10分30秒触发任务 -
30 10 1 ? 10 SUN 2011
2011年10月每周日1点10分30秒触发任务 -
15,30,45 * * * * ?
每15秒,30秒,45秒时触发任务 -
15-45 * * * * ?
15到45秒内,每秒都触发任务 -
15/5 * * * * ?
每分钟的每15秒开始触发,每隔5秒触发一次 -
15-30/5 * * * * ?
每分钟的15秒到30秒之间开始触发,每隔5秒触发一次 -
0 0/3 * * * ?
每小时的第0分0秒开始,每三分钟触发一次 -
0 15 10 ? * MON-FRI
星期一到星期五的10点15分0秒触发任务 -
0 15 10 L * ?
每个月最后一天的10点15分0秒触发任务(L 可以看出来是 Last 的缩写“最后一个”) -
0 15 10 LW * ?
每个月最后一个工作日的10点15分0秒触发任务(LW 可以看出来是 LastWeekday 的缩写“最后一个工作日”) -
0 15 10 ? * 5L
每个月最后一个星期四的10点15分0秒触发任务 -
0 15 10 ? * 5#3
每个月第三周的星期四的10点15分0秒触发任务