Cron表达式用法详细教程
更多用法请参考:阿里云Cron表达式详解
定时任务的执行频率表达式普遍使用的crontab,crontab表达式至少6位,也有7位的,7位表达式多了一个< 秒级>位。
6位表达式
- 分(0~59)
- 时(0~23)
- 日(0~31,但是你需要考虑你月的天数)
- 月(0~11)
- 周(0~6 0=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT)
- 年(1970-2099)
7位表达式
- 秒(0~59)
- 分(0~59)
- 时(0~23)
- 日(0~31,但是你需要考虑你月的天数)
- 月(0~11)
- 周(0~6 0=SUN 或 SUN,MON,TUE,WED,THU,FRI,SAT)
- 年(1970-2099)
举例分析
0 12-45/3 10 * * ? 2005
首先,这是7位表达式,执行频率精确到s0
表示每分钟的第0秒命中12-45/3
表示每小时的第12~45min,每隔3min命中10
表示每天的第10小时命中*
表示每月的每天都命中*
表示每年的每月都命中?
表示无意义,不考虑周几是否命中2025
表示2025年命中
Cron设置只执行一次
cron设置只执行一次,只需要指定具体的时间即可,任务运行状态下,任务执行完毕后会自动删除此任务,无需人工处理删除
// 如: 2020年3月11日13点27分15秒,?指的是不考虑星期几
15 27 13 11 3 ? 2020
在执行云助手命令时,您可以调用API通过Timed参数和Frequency参数设置命令的执行时间。Frequency的取值为一个Cron表达式,适用于周期性执行、日常维护、在某时刻需要完成的单次任务等场景。
Cron表达式介绍
Cron表达式是一个具有时间含义的字符串,字符串以5~6个空格隔开,分为6~7个域,格式为X X X X X X X
。其中X
是一个域的占位符。最后一个代表年份的域非必须,可省略。单个域有多个取值时,使用半角逗号,
隔开取值。每个域可以是确定的取值,也可以是具有逻辑意义的特殊字符。每个域最多支持一个前导零。
说明 如指定2022年每天上午8:15执行任务,Cron表达式可指定为0 15 8 ? * * 2022
或0 15 08 ? * * 2022
,而不能指定为0 15 008 ? * * 2022
。
域取值
下表为Cron表达式中六个域能够取的值以及支持的特殊字符。
域 | 是否必需 | 取值范围 | 特殊字符 |
---|---|---|---|
秒 | 是 | [0, 59] | * , - / |
分钟 | 是 | [0, 59] | * , - / |
小时 | 是 | [0, 23] | * , - / |
日期 | 是 | [1, 31] | * , - / ? L W |
月份 | 是 | [1, 12]或[JAN, DEC] | * , - / |
星期 | 是 | [1, 7]或[MON, SUN]。若您使用[1, 7]表达方式,1 代表星期一,7 代表星期日。 | * , - / ? L # |
年 | 否 | [当前年份,2099] | * , - / |
特殊字符
Cron表达式中的每个域都支持一定数量的特殊字符,每个特殊字符有其特殊含义。
特殊字符 | 含义 | 示例 |
---|---|---|
* | 所有可能的值。 | 在月域中,* 表示每个月;在星期域中,* 表示星期的每一天。 |
, | 列出枚举值。 | 在分钟域中,5,20 表示分别在5分钟和20分钟触发一次。 |
- | 范围。 | 在分钟域中,5-20 表示从5分钟到20分钟之间每隔一分钟触发一次。 |
/ | 指定数值的增量。 | 在分钟域中,0/15 表示从第0分钟开始,每15分钟。在分钟域中3/20 表示从第3分钟开始,每20分钟。 |
? | 不指定值,仅日期和星期域支持该字符。 | 当日期或星期域其中之一被指定了值以后,为了避免冲突,需要将另一个域的值设为? 。 |
L | 单词Last的首字母,表示最后一天,仅日期和星期域支持该字符。 说明 指定 |
|
W | 除周末以外的有效工作日,在离指定日期的最近的有效工作日触发事件。W 字符寻找最近有效工作日时不会跨过当前月份,连用字符LW 时表示为指定月份的最后一个工作日。 | 在日期域中5W ,如果5日是星期六,则将在最近的工作日星期五,即4日触发。如果5日是星期天,则将在最近的工作日星期一,即6日触发;如果5日在星期一到星期五中的一天,则就在5日触发。 |
# | 确定每个月第几个星期几,仅星期域支持该字符。 | 在星期域中,4#2 表示某月的第二个星期四。 |
取值示例
以下为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/30 9-17 * * ? | 每天上午09:00到下午17:00时间段内每隔半小时执行任务 |
0 * 14 * * ? | 每天下午14:00到下午14:59时间段内每隔1分钟执行任务 |
0 0-5 14 * * ? | 每天下午14:00到下午14:05时间段内每隔1分钟执行任务 |
0 0/5 14 * * ? | 每天下午14:00到下午14:55时间段内每隔5分钟执行任务 |
0 0/5 14,18 * * ? | 每天下午14:00到下午14:55、下午18:00到下午18:55时间段内每隔5分钟执行任务 |
0 0 12 ? * WED | 每个星期三中午12:00执行任务 |
0 15 10 15 * ? | 每月15日上午10:15执行任务 |
0 15 10 L * ? | 每月最后一日上午10:15执行任务 |
0 15 10 ? * 6L | 每月最后一个星期六上午10:15执行任务 |
0 15 10 ? * 6#3 | 每月第三个星期六上午10:15执行任务 |
0 10,44 14 ? 3 WED | 每年3月的每个星期三下午14:10和14:44执行任务 |
0 15 10 ? * * 2022 | 2022年每天上午10:15执行任务 |
0 15 10 ? * * * | 每年每天上午10:15执行任务 |
0 0/5 14,18 * * ? 2022 | 2022年每天下午14:00到下午14:55、下午18:00到下午18:55时间段内每隔5分钟执行任务 |
0 15 10 ? * 6#3 2022,2023 | 2022年至2023年每月第三个星期六上午10:15执行任务 |
0 0/30 9-17 * * ? 2022-2025 | 2022年至2025年每天上午09:00到下午17:30时间段内每隔半小时执行任务 |
0 10,44 14 ? 3 WED 2022/2 | 从2022年开始,每隔两年3月的每个星期三下午14:10和14:44执行任务 |
cron的表达式被用来配置CronTrigger实例。 cron的表达式是字符串,实际上是由七子表达式,描述个别细节的时间表。这些子表达式是分开的空白,代表:
1.Seconds
2.Minutes
3.Hours
4.Day-of-Month
5.Month
6.Day-of-Week
7.Year (可选字段)
例 "0 0 12 ? * WED" 在每星期三下午12:00 执行,
个别子表达式可以包含范围, 例如,在前面的例子里("WED")可以替换成 "MON-FRI", "MON, WED, FRI"甚至"MON-WED,SAT".
“*” 代表整个时间段.
每一个字段都有一套可以指定有效值,如
Seconds(秒) :可以用数字0-59 表示,
Minutes(分) :可以用数字0-59 表示,
Hours(时) :可以用数字0-23表示,
Day-of-Month(天) :可以用数字1-31 中的任一一个值,但要注意一些特别的月份
Month(月) :可以用0-11 或用字符串 “JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV and DEC” 表示
Day-of-Week(每周):可以用数字1-7表示(1 = 星期日)或用字符口串“SUN, MON, TUE, WED, THU, FRI and SAT”表示
“/”:为特别单位,表示为“每”如“0/15”表示每隔15分钟执行一次,“0”表示为从“0”分开始, “3/20”表示表示每隔20分钟执行一次,“3”表示从第3分钟开始执行
“?”:表示每月的某一天,或第周的某一天
“L”:用于每月,或每周,表示为每月的最后一天,或每个月的最后星期几如“6L”表示“每月的最后一个星期五”
“W”:表示为最近工作日,如“15W”放在每月(day-of-month)字段上表示为“到本月15日最近的工作日”
““#”:是用来指定“的”每月第n个工作日,例 在每周(day-of-week)这个字段中内容为"6#3" or "FRI#3" 则表示“每月第三个星期五”
1)Cron表达式的格式:秒 分 时 日 月 周 年(可选)。
字段名 允许的值 允许的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小时 0-23 , - * /
日 1-31 , - * ? / L W C
月 1-12 or JAN-DEC , - * /
周几 1-7 or SUN-SAT , - * ? / L C #
年 (可选字段) empty, 1970-2099 , - * /
“?”字符:表示不确定的值
“,”字符:指定数个值
“-”字符:指定一个值的范围
“/”字符:指定一个值的增加幅度。n/m表示从n开始,每次增加m
“L”字符:用在日表示一个月中的最后一天,用在周表示该月最后一个星期X
“W”字符:指定离给定日期最近的工作日(周一到周五)
“#”字符:表示该月第几个周X。6#3表示该月第3个周五
2)Cron表达式范例:
每隔5秒执行一次:*/5 * * * * ?
每隔1分钟执行一次:0 */1 * * * ?
每天23点执行一次:0 0 23 * * ?
每天凌晨1点执行一次:0 0 1 * * ?
每月1号凌晨1点执行一次:0 0 1 1 * ?
每月最后一天23点执行一次:0 0 23 L * ?
每周星期天凌晨1点实行一次:0 0 1 ? * L
在26分、29分、33分执行一次:0 26,29,33 * * * ?
每天的0点、13点、18点、21点都执行一次:0 0 0,13,18,21 * * ?
相关文档
更多推荐
所有评论(0)