cron表达式速查
cron表达式常用于配置定时任务。cron表达式实际上是由七个子表达式组成。这些表达式之间用空格分隔:
- Seconds (秒)
- Minutes(分)
- Hours(小时)
- Day-of-Month (天)
- Month(月)
- Day-of-Week (周)
- Year(年)
例:表达式
0 0 12 ? \* WED
意思是:每个星期三的中午12点执行。
个别子表达式可以包含范围或者列表。例如:上面例子中的WED可以换成MON-FRI
,MON,WED,FRI
",甚至MON-WED,SAT
下表列出了Cron子表达式的取值范围:
Seconds | 0~59 |
Minutes | 0~59 |
Hours | 0~23 |
Day-of-Month | 1~31,但是要注意有些月份没有31天 |
Month | (0~11,或者JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV,DEC |
Day-of-Week | 1~7,或者SUN(=1), MON, TUE, WED, THU, FRI, SAT |
Year | 1970~2099 |
格式 #
Cron表达式的格式:秒 分 时 日 月 周 年(可选)
字段名 | 允许的值 | 允许的特殊字符 |
---|---|---|
秒 | 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 , - * / |
通配/特殊字符的含义 #
* :代表所有可能的值。因此,*
在Month
中表示每个月,在Day-of-Month
中表示每天,在Hours表示每小时。
- :表示指定范围。
, :表示列出枚举值。例如:在Minutes
子表达式中,5,20
表示在5分钟和20分钟触发。
/ :被用于指定增量。例如:在Minutes
子表达式中,0/15
表示从0分钟开始,每15分钟执行一次;3/20
表示从第三分钟开始,
每20分钟执行一次,和3,23,43
(表示第3,23,43分钟触发)的含义一样。
? :用在Day-of-Month
和Day-of-Week
中,指没有具体的值。当两个子表达式其中一个被指定了值以后,为了避免冲突,
需要将另外一个的值设为?
。例如:想在每月20日触发调度,不管20号是星期几,只能用如下写法:0 0 0 20 * ?
,
其中最后一位只能用?
,而不能用*
。
L :用在Day-of-Month
和Day-of-Week
字串中。它是单词“last”的缩写。它在两个子表达式中的含义是不同的。
在Day-of-Month中,L
表示一个月的最后一天,如1月31号,3月30号。 在Day-of-Week中,L
表示一个星期的最后一天,也就是“7”或者“SAT”。
但是如果L
前有具体内容,它就有其他的含义了。例如:6L
表示这个月的倒数第六天。FRIL
表示这个月的最后一个星期五。
注意:在使用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
or FRI#3
指这个月第3个周五(6指周五,3指第3个)。如果指定的日期不存在,触发器就不会触发。
常见表达式示例 #
0 * * * * ? 每1分钟触发一次
0 0 * * * ? 每天每1小时触发一次
0 0 10 * * ? 每天10点触发一次
0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发
0 30 9 1 * ? 每月1号上午9点半
0 15 10 15 * ? 每月15日上午10:15触发
*/5 * * * * ? 每隔5秒执行一次
0 */1 * * * ? 每隔1分钟执行一次
0 0 5-15 * * ? 每天5-15点整点触发
0 0/3 * * * ? 每三分钟触发一次
0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发
0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发
0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时
0 0 10,14,16 * * ? 每天上午10点,下午2点,4点
0 0 12 ? * WED 表示每个星期三中午12点
0 0 17 ? * TUES,THUR,SAT 每周二、四、六下午五点
0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发
0 15 10 ? * MON-FRI 周一至周五的上午10:15触发
0 0 23 L * ? 每月最后一天23点执行一次
0 15 10 L * ? 每月最后一日的上午10:15触发
0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发
0 15 10 * * ? 2005 2005年的每天上午10:15触发
0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发
0 15 10 ? * 6#3 每月的第三个星期五上午10:15触发