本文介绍如何设置Cron表达式。
Cron适用于周期性执行、日常维护、在某时刻需要完成的单次任务等场景。Cron表达式是一个具有时间含义的字符串,字符串以5个空格隔开,分为6个域,格式为X X X X X X
。其中X
是一个域的占位符。单个域有多个取值时,使用半角逗号,
隔开取值。每个域可以是确定的取值,也可以是具有逻辑意义的特殊字符。
域取值
下表为Cron表达式中六个域能够取的值以及支持的特殊字符。
域 | 是否必需 | 取值范围 | 特殊字符 |
秒 | 是 | [0, 59] | 不支持 |
分钟 | 是 | [0, 59] | 对, 和/有限支持(如果使用逗号,数字之间的间隔必须大于等于30分钟;如果使用/ ,/后面的数字必须大于等于30)。 |
小时 | 是 | [0, 23] | * , - / |
日期 | 是 | [1, 31] | * , - / ? L |
月份 | 是 | [1, 12]或[JAN, DEC] | * , - / |
星期 | 是 | [1, 7]或[SUN, SAT]若您使用[1, 7]表达方式,1 代表星期天,2 代表星期一。
|
* , ? |
特殊字符
Cron表达式中的每个域都支持一定数量的特殊字符,每个特殊字符有其特殊含义。
特殊字符 | 含义 | 示例 |
* |
所有可能的值。 | 在月域中,* 表示每个月;在星期域中,* 表示星期的每一天。
|
, |
列出枚举值。 | 在分钟域中,5,40 表示分别在5分钟和40分钟触发一次。
|
- |
范围。 | 在日期域中,5-20 表示从5号到20号之间每天触发一次。
|
/ |
指定数值的增量。 | 在日期域中,1/5 表示从第1号开始,每5天。在小时域中3/8 表示从第3小时开始,每8小时。
|
? |
不指定值,仅日期和星期域支持该字符。 | 当日期或星期域其中之一被指定了值以后,为了避免冲突,需要将另一个域的值设为? 。
|
L |
单词Last的首字母,表示最后一天,当前仅在日期域支持该字符。说明 指定L 字符时,避免指定列表或者范围,否则,会导致逻辑问题。
|
在日期域中,L 表示某个月的最后一天。
|
取值示例
以下为Cron表达式的取值示例。
示例 | 说明 |
0 15 10 ? * * |
每天上午10:15执行任务 |
0 15 10 * * ? |
每天上午10:15执行任务 |
0 0 12 * * ? |
每天中午12:00执行任务 |
0 0 10,14,16 * * ? |
每天上午10:00点、下午14:00以及下午16:00执行任务 |
0 0/40 9-17 * * ? |
每天上午09:00到下午17:00时间段内每隔40分钟执行任务 |
0 0 12 ? * WED |
每个星期三中午12:00执行任务 |
0 15 10 15 * ? |
每月15日上午10:15执行任务 |
0 15 10 L * ? |
每月最后一日上午10:15执行任务 |
0 0,30 14 ? 3 WED |
每年3月的每个星期三下午14:00到14:30时间段内执行任务 |