Java Spring cron表达式使用详解

Java Spring cron表达式使用详解

 

By:授客 QQ:1033553122

语法格式

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触发