Spring cron 表达式

Spring cron 表达式

一、格式


Cron Expressions

cron的表达式被用来配置CronTrigger实例。 cron的表达式是字符串,实际上是由七子表达式,描述个别细节的时间表。

Cron表达式是一个字符串,字符串以5或6个空格隔开,分开工6或7个域,每一个域代表一个含义,Cron有如下两种语法 
格式: 
Seconds Minutes Hours DayofMonth Month DayofWeek Year 或 
Seconds Minutes Hours DayofMonth Month DayofWeek 

{秒} {分} {时} {日} {月} {周} {年(可选)}
每一个域可出现的字符如下:

Seconds:可出现,-  *  / 四个字符,有效范围为0-59的整数    
Minutes:可出现,-  *  / 四个字符,有效范围为0-59的整数    
Hours:可出现,-  *  / 四个字符,有效范围为0-23的整数    

"*" 代表每隔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
DayofMonth:可出现,-  *  / ? L W C八个字符,有效范围为0-31的整数  

"*" 代表每天触发;
"?" 与{周}互斥,即意味着若明确指定{周}触发,则表示{日}无意义,以免引起 冲突和混乱; 
"," 代表在指定的日期触发,比如"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" 根据日历触发,由于使用较少,暂时不做解释


Month:可出现,-  *  / 四个字符,有效范围为1-12的整数或JAN-DEc    
DayofWeek:可出现,-  *  / ? L C #四个字符,有效范围为1-7的整数或SUN-SAT两个范围。1表示星期天,2表示星期一, 依次类推    

"*" 代表每星期都触发; 
"?" 与{日}互斥,即意味着若明确指定{日}触发,则表示{周}无意义,以免引起冲突和混乱 "," 代表在指定的星期约定触发,比如"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" 根据日历触发,由于使用较少,暂时不做解释

Year:可出现,-  *  / 四个字符,有效范围为1970-2099年   

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

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

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


 二、配置


<task:scheduled ref="beanID" method="方法名" initial-delay="延迟毫秒"  fixed-delay="周期毫秒"  />

  注意:initial-delay和fixed-delay属性在spring 3.2版本以上有效,3.0就没有,并且3.2以上定时任务,服务器启动完成后会自动执行一次定时任务的,无需自己触发,如果有多个任务,initial-delay属性可以设置任务的等待时间,来解决任务的先后执行顺序。


三、常用事例


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

猜你喜欢

转载自blog.csdn.net/superhoy/article/details/77855387