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位表达式，执行频率精确到s
0 表示每分钟的第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的首字母，表示最后一天，仅日期和星期域支持该字符。 说明 指定L字符时，避免指定列表或者范围，否则，会导致逻辑问题。	在日期域中，L表示某个月的最后一天。在星期域中，L表示一个星期的最后一天，也就是星期日（SUN）。 如果在L前有具体的内容，例如，在星期域中的6L表示这个月的最后一个星期六。
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 * * ?

相关文档

• InvokeCommand
• RunCommand