Cron表达式

Posted jingjiren

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Cron表达式相关的知识,希望对你有一定的参考价值。

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”表示这个月的倒数第6天,“FRIL”表示这个月的最一个星期五 。 ③.在使用“L”参数时,不要指定列表或范围,因为这会导致问题

常用案例:

每隔5秒执行一次:*/5 * * * * ?

每隔1分钟执行一次:0 */1 * * * ?

每天23点执行一次:0 0 23 * * ?

每天凌晨1点执行一次:0 0 1 * * ?

每月1号凌晨1点执行一次:0 0 1 1 * ?

每月最后一天23点执行一次:0 0 23 L * ?

每周星期天凌晨1点实行一次:0 0 1 ? * L

在26分、29分、33分执行一次:0 26,29,33 * * * ?

每天的0点、13点、18点、21点都执行一次:0 0 0,13,18,21 * * ? 
"0 0-5 14 * * ?"     在每天下午2点到下午2:05期间的每1分钟触发,准点执行,不是从启动开始间隔1分钟
"0 1-59 16 * * ?"     在每天下午2点-3点之间,每分钟执行一次,准点执行,不是从启动开始间隔1分钟
"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表达式的主要内容,如果未能解决你的问题,请参考以下文章

spring cron表达式

关于Cron表达式和quartzmanage

APScheduler的cron触发器支持到秒级的cron表达式

关于Cron表达式和quartzmanage

如何通过Cron表达式来获取最近运行时间

CRON 表达式在每个月的最后一天触发 Azure 函数