一个cron表达式有至少6个(也可能7个)有空格分隔的时间元素。按顺序依次为:
- 秒(0~59)
- 分钟(0~59)
- 小时(0~23)
- 天(0~31)
- 月(0~11)
- 星期(写法1:1~7 1=SUN;写法2:SUN,MON,TUE,WED,THU,FRI,SAT)
- 年份(1970-2099)
其中每个元素可以式一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/4表示每隔4小时),一个列表(1,3,5),通配符。由于"日期"和"星期"这两个元素互斥的,必须要对其中一个设置。
配置实列:
- 每个5秒执行一次:
/5 * ?
- 每隔1分钟执行一次:
0 /1 ?
- 每天上午10点,下午两点,4点:
0 0 10,14,16 ?
- 朝九晚五工作时间内每半小时:
0 0/30 9-17 ?
- 表示每个星期三中午12点:
0 0 12 ? * WED
- 每天中午12点触发:
0 0 12 ?
- 每天上午10:15触发(结尾有空格,为了方便看清加了引号):
"0 15 10 ? "
- 每天上午10:15触发:
0 15 10 ?
- 每天上午10:15触发:
0 15 10 ? *
- 2005年每天上午10:15触发:
0 15 10 ? 2005
- 在每天下午2点到下午2:59期间的每1分钟触发:
0 14 * ?
- 在每天下午2点到下午2:55期间的每5分钟触发:
0 0/5 14 ?
- 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发:
0 0/5 14,18 ?
- 在每天下午2点到下午2:05期间的每1分钟触发:
0 0-5 14 ?
- 每年三月的星期三的下午2:10和2:44触发:
0 10,44 14 ? 3 WED
- 周一至周五的上午10:15触发:
0 15 10 ? * MON-FRI
- 每月15日上午10:15触发:
0 15 10 15 * ?
- 每月最后一日的上午10:15触发:
0 15 10 L * ?
- 每月的最后一个星期五上午10:15触发:
0 15 10 ? * 6L
- 2002年至2005年的每月的最后一个星期五上午10:15触发:
0 15 10 ? * 6L 2002-2005
- 每月的第三个星期五上午10:15触发:
0 10 10 ? * 6#3
有些子表达式能包含一些范围或列表
例如: 子表达式(星期)可以为 MON-FRI
, MON,WED,FRI
, MON-WED,SAT
, *
字符代表所有可能的值,/
字符用来指定数值的增量
例如: 在子表达式(分钟)里的 0/15
表示从第0分钟开始,每15分钟在子表达式(分钟)里的 3/20
表示从第3分钟开始,每20分钟(它和3,23,43
)的含义一样 ?
字符仅被用于 “日期” 和 “星期” 两个子表达式,表示不指定值,当两个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设置为?
L
字符仅被用于"日期"和"星期"两个子表达式,它是单词"last"的缩写如果在"L"前有具体的内容,它就具有其他的含义了。
例如: “6L” 表示这个月的倒数第6天 在使用“L”参数时,不要指定列表或范围,因为这会导致问题"W"字符代表着“平日(Mon-Fri)”,并且仅能用于日期中。它用来指定日离指定日最近的一个平日。大部分的商业处理都是基于工作周的,所以 W 字符可能是非常重要的
例如,日期中的15W
意味着“离该月15号的最近一个平日。”假如15号是星期六,那么trigger会在14号(星期五)触发,因为星期四比星期一离15号更近。C: 代表“Calendar”的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。
例如,5C在日期字段就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天
字段 | 允许值 | 允许的特殊字符 |
---|---|---|
秒 | 0~59 | , - * / |
分 | 0~59 | , - * / |
小时 | 0~23 | , - * / |
日期 | 1-31 | , - * ? / L W C |
月份 | 112或者JANDEC | , - * / |
星期 | 17或者SUNSAT | , - * ? / L C # |
年(可选) | 留空,1970~2099 | , - * / |