corn表达式

在制定较为复杂的计划任务时,可以通过配置cron表达式,来指定任务在某个时间点或者周期性的执行。 cron表达式配置起来灵活方便,是一种较为通用的定时任务调度设置方法。

1、cron表达式的组成

cron表达式是一个字符串,由6到7个字段组成,用空格分隔。其中前6个字段是必须的,最后一个是可选的。每个字段的含义如图所示:
从左到右,依次对每个字段指定相应的值,就可以确定一个任务的执行时间点和周期了。
值可以由数字配合字符来组合,如下:
字段允许值允许的特殊字符
0-59暂不支持(, - * /)
0-59暂不支持(, - * /)
小时0-23暂不支持(, - * /)
日期1-31, - * ? / L W C
月份1-12 或者 JAN-DEC, - * /
星期1-7 或者 SUN-SAT,1表示星期日,7表示星期六, - * ? / L C #
年(可为空)留空, 1970-2099, - * /

(1)秒

允许值范围: 0~59 ,不允许为空值,若值不合法,调度器将抛出SchedulerException异常
"*" 代表每隔1秒钟触发
"," 代表在指定的秒数触发,比如"0,15,45"代表0秒、15秒和45秒时触发任务
"-" 代表在指定的范围内触发,比如"25-45"代表从25秒开始触发到45秒结束触发,每隔1秒触发1次
"/" 代表触发步进(step),"/"前面的值代表初始值("*"等同"0"),后面的值代表偏移量,比如"0/20"或者"*/20"代表从0秒钟开始,每隔20秒钟触发1次,即0秒触发1次,20秒触发1次,40秒触发1次;"5/20"代表5秒触发1次,25秒触发1次,45秒触发1次;"10-45/20"代表在[10,45]内步进20秒命中的时间点触发,即10秒触发1次,30秒触发1次

(2)分钟

允许值范围: 0~59 ,不允许为空值,若值不合法,调度器将抛出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次

(3)小时

允许值范围: 0~23 ,不允许为空值,若值不合法,调度器将抛出SchedulerException异常
"*" 代表每隔1小时触发
"," 代表在指定的时间点触发,比如"10,20,23"代表10点钟、20点钟和23点触发任务
"-" 代表在指定的时间段内触发,比如"20-23"代表从20点开始触发到23点结束触发,每隔1小时触发
"/" 代表触发步进(step),"/"前面的值代表初始值("*"等同"0"),后面的值代表偏移量,比如"0/1"或者"*/1"代表从0点开始触发,每隔1小时触发1次;"1/2"代表从1点开始触发,以后每隔2小时触发一次

(4)日期

允许值范围: 1~12 (JAN-DEC),不允许为空值,若值不合法,调度器将抛出SchedulerException异常
"*" 代表每个月都触发
"," 代表在指定的月份触发,比如"1,6,12"代表1月份、6月份和12月份触发任务
"-" 代表在指定的月份范围内触发,比如"1-6"代表从1月份开始触发到6月份结束触发,每隔1个月触发
"/" 代表触发步进(step),"/"前面的值代表初始值("*"等同"1"),后面的值代表偏移量,比如"1/2"或者"*/2"代表从1月份开始触发,每隔2个月触发1次;"6/6"代表从6月份开始触发,以后每隔6个月触发一次;"1-6/12"表达式意味着每年1月份触发

(5)星期

允许值范围: 1~7 (SUN-SAT),1代表星期天(一星期的第一天),以此类推,7代表星期六(一星期的最后一天),不允许为空值,若值不合法,调度器将抛出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"这种形式只不过是"#"的特殊形式而已

(6)年份

允许值范围: 1970~2099 ,允许为空,若值不合法,调度器将抛出SchedulerException异常
"*"代表每年都触发
","代表在指定的年份才触发,比如"2011,2012,2013"代表2011年、2012年和2013年触发任务
"-"代表在指定的年份范围内触发,比如"2011-2020"代表从2011年开始触发到2020年结束触发,每隔1年触发
"/"代表触发步进(step),"/"前面的值代表初始值("*"等同"1970"),后面的值代表偏移量,比如"2011/2"或者"*/2"代表从2011年开始触发,每隔2年触发1次
注意:除了{日期}和{星期}可以使用"?"来实现互斥,表达无意义的信息之外,其他占位符都要具有具体的时间含义,且依赖关系为:年->月->日期(星期)->小时->分钟->秒数

(7)特殊字符

特殊字符含义示例
*匹配任意值。在字段中,*表示每个月。在字段小时中,*表示每小时。在字段分钟中,*表示每分钟。
,列出枚举值。在字段分钟中,5,20表示分别在5分钟和20分钟触发一次。
-指定范围。在字段分钟中,5-20表示从5分钟到20分钟之间每隔一分钟触发一次。
/指定数值的增量。在字段分钟中,0/15表示从第0分钟开始,每15分钟。在字段分钟3/20表示从第3分钟开始,每20分钟。
?不指定值,仅用于日期和星期。当字段日期星期其中之一被指定了值以后,为了避免冲突,需要将另一个字段的值设为?
L单词Last的首字母,表示最后一天,仅字段日期支持该字符。在字段日期中,L表示某个月的最后一天。在字段日期中,L表示一个星期的最后一天,也就是星期日(SUN)。如果在L前有具体的内容,例如,在字段星期中的6L表示这个月的最后一个星期六。
W除周末以外的有效工作日,在离指定日期的最近的有效工作日触发事件。W字符寻找最近有效工作日时不会跨过当前月份,连用字符LW时表示为指定月份的最后一个工作日。在字段日期5W,如果5日是星期六,则将在最近的工作日星期五,即4日触发。如果5日是星期天,则将在最近的工作日星期一,即6日触发;如果5日在星期一到星期五中的一天,则就在5日触发。
#确定每个月的第几个星期几。仅字段星期支持该字符。在字段星期中,4#2表示某月的第二个星期四。

2、常见场景示例

调度频率corn表达式任务场景
分钟00*/30 00-23**?每天00:00~23:59的时间段内,每隔30分钟调度一次
小时00 00 00-23/6 **?每天00:00~23:59的时间段内,每隔6小时自动调度一次
00 00 20**?每天20:00点调度
星期00 00 10?*1,5每周一、周五两天的10:00调度
00 00 22L*?每月最后一天的22:00调度
00 30 22 L 1,6,12 每年的一月、六月、十二月的最后1日的22:30调度
更多其他场景:

3、corn表达式在线生成器

网上可以找到很多的cron表达式在线生成器:
2025-03-10
0