Java Spring cron表达式使用详解

2019-09-11 16:21:19 浏览数 (2)

语法格式

Seconds Minutes Hours DayofMonth Month DayofWeek Year

Seconds Minutes Hours DayofMonth Month DayofWeek

域字段说明

域 取值范围 允许的特殊字符

秒(Seconds) 0-59 , - * /

分(Minutes) 0-59 , - * /

小时(Hours) 0-23 , - * /

日期(DayofMonth) 1-31 , - * / L W C

月份(Month) 1-12、JAN-DEC , - * /

星期(DayofWeek) 1-7或者 SUN-SAT , - * ? / L C #

年(Year,可选) 留空, 1970-2099 , - * /

* 表示匹配该域的所有值,比如在Minutes域使用 * , 即表示每分钟都会触发事件。

? 只能用在DayofMonth和DayofWeek两个域中使用。它被用来指定“非明确的值”。因为DayofMonth和 DayofWeek会相互影响,当着两个元素互斥时,应该通过设置一个问号(?)来表明不想设置那个字段。例如,想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ?, 其中最后一位只能用?,而不能使用*,如果使用 * 表示不管星期几都会触发,实际上并不是这样。

- 表示范围,例如,在Minutes域使用 5-20,表示从5分到20分钟,每分钟触发一次。又如在Hours域使用 10-12,表示从10点到12点,每小时即每个整点触发一次。

/ 用来指定渐增的值。例如在Seconds域使用 0/15,表示从第0秒开始(包括第0秒),每15秒钟触发一次,即在第0,15,30,45秒的时候各触发一次。又如在Seconds域使用5/15,表示从第5秒开始,每15秒触发一次,即在在第5,20,35,50秒的时候各触发一次。

在/前面指定0、*是等价的,即 */ 和 0/ 是等价的。

注意:触发事件执行的时间点必须是在取值范围内才有效。比如 在Minutes域使用 40/20,表示从第40分钟开始,每20分钟执行一次,但是Minutes取值范围为0-59,40 20=60,不在取值范围内,所以仅会在每小时的第40分钟执行一次。而如果设置为40/10,则会在第40,50分钟各执行一次。又如在Month域中设置 7/6,则仅会在7月出发一次。

, 用于指定枚举值。比如,在Minutes域使用5,20,则表示在第5,20分钟时各触发一次。又如,在DayofWeek使用 MON,WED,FRI,表示星期一、星期三、星期五

L 表示最后(last),只能用于DayofWeek和DayofMonth域,如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。如果在DayofMonth域中使用 L 则表示一个月的最后一天--非闰年,对于1月来说,则是1.31,对于2月则是2.28 , 如果在DayofWeek域使用L则表示 7 或者 SAT 即星期六,如果在DayofWeek域使用L,并在L前面加上数字,它表示该月最后一个星期×,例如 6L 就表示一个月的最后一个 星期五

W 只能用于DayofMonth域。用来指定离给定日期最近的工作日(周一到周五)。比如DayofMonth域使用 15W,则表示"离该月15号最近的工作日"。因此如果15号为周六,触发器会在14号即周五调用。如果15号为周日,触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将DayofMonth域设为 1W ,而1号又是周六,触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。

LW L和W 这两个字符可以组合为 LW,用于DayofMonth域,表示该月最后一个工作日,即最后一个星期五。

# 字符可用于DayofWeek域。表示“该月第几个周×”,比如"6#3"表示该月第三个周五( 6表示周五,而#3 表示该月第三个)。又如 "2#1" 表示该月第一个周一。

注意:如果指定"5#5",该月没有第五个“周5”,该月是不会触发的,即第几个周x必须在当月范围内存在。

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

常见的一些例子

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,每1分钟触发一次

0 0/5 14 * * ? 每天下午2点到2:55,每5分钟触发一次

0 0/5 14,18 * * ? 每天下午2点到2:55,下午6点到6:55,每5分钟触发一次

0 0-5 14 * * ? 每天下午2点到2:05,每1分钟触发一次

0 10,44 14 ? 3 WED 每年三月的星期三,下午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 每月的第三个星期五上午10:15触发

0 人点赞