首页手记 Spring Task 中cron表达式整理记录

Spring Task 中cron表达式整理记录

标签：

Java

1.cron表达式格式：

{秒} {分} {时} {日} {月} {周} {年(可选)}

2.cron各选项的取值范围及解释：
{秒}：取值范围(0-59)，不允许为空值，若值不合法，调度器将抛出SchedulerException异常
{分}：取值范围(0-59)，不允许为空值，若值不合法，调度器将抛出SchedulerException异常
{时}：取值范围(0-23)，不允许为空值，若值不合法，调度器将抛出SchedulerException异常

"*" 代表每隔1分/秒/时触发；
"," 代表在指定的分/秒/时触发，比如"10,20,40"代表10分/秒/时、20分/秒/时和40分/秒/时时触发任务
"-" 代表在指定的范围内触发，比如"5-30"代表从5分/秒/时开始触发到30分/秒/时结束触 发，每隔1分/秒/时触发
"/" 代表触发步进(step)，"/"前面的值代表初始值("*"等同"0")，后面的值代表偏移量，比如"0/25"或者"*/25"代表从0分/秒/时开始，每隔25分/秒/时触发1次，即0分/秒/时触发1次，第25分/秒/时触发1次，第50分/秒/时触发1次；"5/25"代表5分/秒/时触发1次，30分/秒/时触发1次，55分/秒/时触发1次；"10-45/20"代表在[10,45]内步进20分/秒/时命中的时间点触发，即10分/秒/时触发1次，30分/秒/时触发1次

{日}：取值范围(1-31)，不允许为空值，若值不合法，调度器将抛出SchedulerException异常

"*" 代表每天触发；
"?" 与{周}互斥，即意味着若明确指定{周}触发，则表示{日}无意义，以免引起 冲突和混乱；
"," 代表在指定的日期触发，比如"1,10,20"代表1号、10号和20号这3天触发；
"-" 代表在指定的日期范围内触发，比如"10-15"代表从10号开始触发到15号结束触发，每隔1天触发
"/" 代表触发步进(step)，"/"前面的值代表初始值("*"等同"1")，后面的值代表偏移量，比如"1/5"或者"*/5"代表从1号开始触发，每隔5天触发1次；"10/5"代表从10号开始触发，以后每隔5天触发一次；"1-10/2"表达式意味着在[1,10]范围内，每隔2天触发，即1号，3号，5号，7号，9号触发
"L" 如果{日}占位符如果是"L"，即意味着当月的最后一天触发
"W "意味着在本月内离当天最近的工作日触发，所谓最近工作日，即当天到工作日的前后最短距离，如果当天即为工作日，则距离为0；所谓本月内的说法，就是不能跨月取到最近工作日，即使前/后月份的最后一天/第一天确实满足最近工作日；因此，"LW"则意味着本月的最后一个工作日触发，"W"强烈依赖{月}
"C" 根据日历触发，由于使用较少，暂时不做解释

{月}：取值范围(1-12或JAN-DEC)，不允许为空值，若值不合法，调度器将抛出SchedulerException异常
{周}：取值范围(1-7或SUN-SAT)，1表示星期天，2表示星期一，依次类推，不允许为空值，若值不合法，调度器将抛出SchedulerException异常

"*" 代表每星期都触发；
"?" 与{日}互斥，即意味着若明确指定{日}触发，则表示{周}无意义，以免引起冲突和混乱
"," 代表在指定的星期约定触发，比如"1,3,5"代表星期天、星期二和星期四触发
"-" 代表在指定的星期范围内触发，比如"2-4"代表从星期一开始触发到星期三结束触发，每隔1天触发
"/" 代表触发步进(step)，"/"前面的值代表初始值("*"等同"1")，后面的值代表偏移量，比如"1/3"或者"*/3"代表从星期天开始触发，每隔3天触发1次；"1-5/2"表达式意味着在[1,5]范围内，每隔2天触发，即星期天、星期二、星期四触发
"L" 如果{周}占位符如果是"L"，即意味着星期的的最后一天触发，即星期六触发，L= 7或者 L = SAT，因此，"5L"意味着一个月的最后一个星期四触发
"#" 用来指定具体的周数，"#"前面代表星期，"#"后面代表本月第几周，比如"2#2"表示本月第二周的星期一，"5#3"表示本月第三周的星期四，因此，"5L"这种形式只不过是"#"的特殊形式而已
"C" 根据日历触发，由于使用较少，暂时不做解释

{年}：取值范围(1970-2099)，允许为空值，（非空时）若值不合法，调度器将抛出SchedulerException异常

注：
①.秒、分、时、月、年这5项的占位符以及占位符的使用规则是一致的（只是单位上的区别），日、周中标红的两条需要重点比较！

②.“?”和“L”字符仅被用于{日}和{周}两个子表达式，表示不指定值。对于“?”的应用，当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“?”；在{日}表达式中，“L”表示一个月的最后一天，在{周}自表达式中，“L”表示一个星期的最后一天。如果在“L”前有具体的内容，它就具有其他的含义了。例如：“6L”表示这个月的倒数第６天，“FRIL”表示这个月的最一个星期五。

③.在使用“L”参数时，不要指定列表或范围，因为这会导致问题

常用案例：

"0 0 10,14,16 * * ?" 每天上午10点，下午2点，4点 
"0 0/30 9-17 * * ?" 朝九晚五工作时间内每半小时 
"0 0 12 ? * WED" 表示每个星期三中午12点 
"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触发
"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秒触发任务
"0 15 10 LW * ?" 每个月最后一个工作日的10点15分0秒触发任务
"0 15 10 ? * 5L" 每个月最后一个星期四的10点15分0秒触发任务
"0 15 10 ? * 5#3" 每个月第三周的星期四的10点15分0秒触发任务
"0 0 0 * * ?" 每天晚上12点触发任务

参考内容：
搜集整理一些Cron表达式例子
 Cron表达式详解
 Cron 表达式详解和案例
 在线Cron表达式生成器