AnalyticDB PostgreSQL版设置周期执行的计划时,需要使用Cron表达式,本文为您介绍什么是Cron表达式以及相关示例。
Cron表达式是一个具有时间含义的字符串,字符串以5~6个空格隔开,分为6~7个域,格式为秒 分钟 小时 日期 月份 星期 年
。最后一个代表年份的域非必须,可省略。单个域有多个取值时,使用半角逗号(,)隔开取值。每个域可以是确定的取值,也可以是通配符。
域取值
下表为Cron表达式中六个域的取值范围以及支持的通配符。
域 | 是否必需 | 取值范围 | 通配符 |
---|---|---|---|
秒 | 是 | [0, 59] | * , - / |
分钟 | 是 | [0, 59] | * , - / |
小时 | 是 | [0, 23] | * , - / |
日期 | 是 | [1, 31] | * , - / ? L W |
月份 | 是 | [1, 12]或[JAN, DEC] | * , - / |
星期 | 是 | [1, 7]或[MON, SUN]。若您使用[1, 7]表达方式,1 代表星期一,7 代表星期日。
|
* , - / ? L # |
年 | 否 | [1970,2099] | * , - / |
通配符
Cron表达式中的每个域都支持通配符,每个通配符有其特殊含义。
通配符 | 含义 | 示例 |
---|---|---|
* |
所有值。 | 在月域中,* 表示每个月;在星期域中,* 表示星期的每一天。
|
, |
列出枚举值。 | 在分钟域中,5,20 表示分别在5分钟和20分钟触发一次。
|
- |
范围。 | 在分钟域中,5-20 表示从5分钟到20分钟之间每分钟触发一次。
|
/ |
指定数值的增量。 | 在分钟域中,0/15 表示从第0分钟开始,每15分钟触发一次。3/20 表示从第3分钟开始,每20分钟触发一次。
|
? |
不指定值。仅日期和星期域支持该字符。 | 当日期或星期域其中之一被指定了值以后,为了避免冲突,需要将另一个域的值设为? 。
|
L |
单词Last的首字母,表示最后一天。仅日期和星期域支持该字符。
说明 指定
L 字符时,避免指定列表或者范围,否则,会导致逻辑问题。
|
|
W |
除周末以外的工作日,在离指定日期的最近的工作日触发事件。W 字符寻找最近工作日时不会跨过当前月份,连用字符LW 时表示为指定月份的最后一个工作日。仅日期域支持该字符。
|
在日期域中5W ,如果5日是星期六,则将在最近的工作日星期五,即4日触发。如果5日是星期天,则将在最近的工作日星期一,即6日触发。如果5日在星期一到星期五中的一天,则就在5日触发。
|
# |
每个月第几个星期几。仅星期域支持该字符。 | 在星期域中,4#2 表示某月的第二个星期四。
|
示例
以下为Cron表达式的取值示例。
注意 计划管理的Cron表达式使用的是UTC时间,实际使用时请将当地时间转换成UTC时间。
场景 | 示例(场景为UTC时间时) | 示例(场景为北京时间时) |
---|---|---|
每天上午10:15执行计划 | 0 15 10 ? * * |
0 15 18 ? * * |
每天上午10:15执行计划 | 0 15 10 * * ? |
0 15 18 * * ? |
每天中午12:00执行计划 | 0 0 12 * * ? |
0 0 20 * * ? |
每天上午10:00点、下午14:00以及下午16:00执行计划 | 0 0 10,14,16 * * ? |
0 0 18,22,0 * * ? |
每天上午09:00到下午17:00时间段内每隔半小时执行计划 | 0 0/30 9-17 * * ? |
0 0/30 17-2 * * ? |
每天下午14:00到下午14:59时间段内每隔1分钟执行计划 | 0 * 14 * * ? |
0 * 22 * * ? |
每天下午14:00到下午14:05时间段内每隔1分钟执行计划 | 0 0-5 14 * * ? |
0 0-5 22 * * ? |
每天下午14:00到下午14:55时间段内每隔5分钟执行计划 | 0 0/5 14 * * ? |
0 0/5 22 * * ? |
每天下午14:00到下午14:55、下午18:00到下午18:55时间段内每隔5分钟执行计划 | 0 0/5 14,18 * * ? |
0 0/5 22,3 * * ? |
每个星期三中午12:00执行计划 | 0 0 12 ? * WED |
0 0 20 ? * WED |
每月15日上午10:15执行计划 | 0 15 10 15 * ? |
0 15 18 15 * ? |
每月最后一日上午10:15执行计划 | 0 15 10 L * ? |
0 15 18 L * ? |
每月最后一个星期六上午10:15执行计划 | 0 15 10 ? * 6L |
0 15 18 ? * 6L |
每月第三个星期六上午10:15执行计划 | 0 15 10 ? * 6#3 |
0 15 18 ? * 6#3 |
每年3月的每个星期三下午14:10和14:44执行计划 | 0 10,44 14 ? 3 WED |
0 10,44 22 ? 3 WED |
2022年每天上午10:15执行计划 | 0 15 10 ? * * 2022 |
0 15 18 ? * * 2022 |
每年每天上午10:15执行计划 | 0 15 10 ? * * * |
0 15 18 ? * * * |
2022年每天下午14:00到下午14:55、下午18:00到下午18:55时间段内每隔5分钟执行计划 | 0 0/5 14,18 * * ? 2022 |
0 0/5 22,3 * * ? 2022 |
2022年至2023年每月第三个星期六上午10:15执行计划 | 0 15 10 ? * 6#3 2022,2023 |
0 15 18 ? * 6#3 2022,2023 |
2022年至2025年每天上午09:00到下午17:30时间段内每隔半小时执行计划 | 0 0/30 9-17 * * ? 2022-2025 |
0 0/30 17-2 * * ? 2022-2025 |
从2022年开始,每隔两年3月的每个星期三下午14:10和14:44执行计划 | 0 10,44 14 ? 3 WED 2022/2 |
0 10,44 22 ? 3 WED 2022/2 |