https://www.zhyd.me/article/43
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”参数时,不要指定列表或范围,因为这会导致问题
常用案例:
"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点