目录
一、cron相关参数意义
二、cron特殊字符含义及字段限制
含义
限制
cron生成工具
三、除了cron,@Scheduled注解中其他参数
3.1 zone
3.2 fixedDelay、fixedDelayString
3.3 fixedRate、fixedRateString
3.4 initialDelay、initialDelayString
一、cron
相关参数意义
一个cron
表达式有至少6个(也可能7个)有空格分隔的时间元素。如下:
- 秒(0~59) 例如0/5表示每5秒
- 分钟(0~59)
- 小时(0~23)
- 天(月)(0~31,但是你需要考虑你月的天数)
- 月(0~11)
- 天(星期)(1~7 1=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT)
- 年份(1970-2099)——@Scheduled是不支持的,spring quartz支持
下面是一些案例解释:
0 0 10,14,16 * * ? | 每天上午10点,下午2点,4点 |
0 0/30 9-17 * * ? | 朝九晚五工作时间内每半小时 |
0 0 12 * * ? | 每天中午12点触发 |
0 15 10 ? * */0 15 10 * * ?/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 * * ? | 在每天下午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 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触发 |
二、cron
特殊字符含义及字段限制
含义
- 子表达式(天(星期))可以为 “MON-FRI”,“MON,WED,FRI”,“MON-WED,SAT”
- “*”字符代表所有可能的值
- “/”字符用来指定数值的增量
- “?”字符仅被用于天(月)和天(星期)两个子表达式,表示不指定值
- “L” 字符仅被用于天(月)和天(星期)两个子表达式,它是单词“last”的缩写
在天(月)子表达式中,“L”表示一个月的最后一天
在天(星期)自表达式中,“L”表示一个星期的最后一天,也就是SAT - 在“L” 前有具体的内容,
“6L”
表示这个月的倒数第6天,“FRIL”
表示这个月的最一个星期五
限制
1.在使用“L”参数时,不要指定列表或范围
2.字段限制
字段 | 允许值 | 允许的特殊字符 |
秒 | 0-59 | , - * / |
分 | 0-59 | , - * / |
小时 | 0-23 | , - * / |
日期 | 1-31 | , - * ? / L W C |
月份 | 1-12 或者 JAN-DEC | , - * / |
星期 | 1-7 或者 SUN-SAT | , - * ? / L C # |
年(可选) | 留空, 1970-2099 | , - * / |
3.@Scheduled的cron
无法指定执行的年份
cron生成工具
三、除了cron,
@Scheduled注解中其他参数
3.1 zone
时区,接收一个 java.util.TimeZone#ID
。cron
表达式会基于该时区解析。默认是一个空字符串,即取服务器所在地的时区。比如我们一般使用的时区Asia/Shanghai。该字段我们一般留空。
Timezone=Asia/Shanghai
3.2 fixedDelay
、fixedDelayString
相同点:都表示上一次执行完毕时间点之后多长时间再执行。
区别点:后者支持占位符。
//上一次执行完毕时间点之后5秒再执行
@Scheduled(fixedDelay = 5000)
@Scheduled(fixedDelayString = "5000")
3.3 fixedRate
、fixedRateString
相同点:都表示上一次执行开始时间点之后多长时间再执行。
区别点:后者支持占位符。
//上一次开始执行时间点之后5秒再执行
@Scheduled(fixedRate = 5000)
@Scheduled(fixedRateString = "5000")
3.4 initialDelay
、initialDelayString
相同点:都表示第一次延迟多长时间后再执行之后多长时间再执行。
区别点:后者支持占位符。
//第一次延迟1秒后执行,之后按fixedRate的规则每5秒执行一次
@Scheduled(initialDelay=1000, fixedRate=5000)
@Scheduled(initialDelayString="1000", fixedRate=5000)