Cron表达式是一个由 7个子表达式组成的字符串。每个子表达式都描述了一个单独的日程细节。这些子表达式用空格分隔。
Cron表达式说明:
秒 |
分 |
时 |
日 |
月 |
周 |
年 |
Seconds |
Minutes |
Hours |
Day-of-Month |
Month |
Day-of-Week |
Year |
秒 |
分钟 |
小时 |
月中的天 |
月 |
周中的天 |
年 |
子表达式说明:
是否必须 |
取值范围 |
特殊字符 |
|
秒 |
是 |
0-59 |
, - * / |
分 |
是 |
0-59 |
, - * / |
时 |
是 |
0-23 |
, - * / |
日 |
是 |
1-31(需要考虑实际月份) |
, - * / ? L W C |
月 |
是 |
1-12 或 JAN-DEC |
, - * / |
周 |
是 |
1-7 或 SUN-SAT |
, - * / ? L C # |
年 |
否 |
空或 1970-2099 |
, - * / |
注意:Cron表达式对特殊字符的大小写不敏感,对代表星期的缩写英文大小写也不敏感。
特殊字符
* |
星号 |
通配字符,表示该字段可以接受任何可能的值。匹配该域的任意值。 |
? |
问号 |
只能用在日和周域上,但是不能在这两个域上同时使用。表示不指定值,未说明的值,即不关心它为何值。 |
# |
井号 |
只能用于周域中。它用于指定月份中的第几周的哪一天。 |
/ |
斜杠 |
用来指定数值的增量。例如a/b表示从a开始每次增加b。 |
- |
中划线 |
用于指定一个范围。 |
, |
逗号 |
用于指定一个列表值。 |
L |
字母 |
只能用在日和周域上。某域上允许的最后一个值。 |
W |
字母 |
只能用于日域中,代表着工作日。 |
C |
字母 |
只在日期和星期字段中使用,代表"Calendar"的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。 |
星号(*)
代表所有可能的值,匹配该域合法的任意值。因此," * "在子表达式【月】里表示每个月的含义," * "在子表达式【周】表示星期的每一天。
问号(?)
只能用在日和周域上,但是不能在这两个域上同时使用。表示不指定值。你可以认为 ? 字符是 "我并不关心在该域上是什么值。" 这不同于星号,星号是指示着该域上的每一个值。? 是说不为该域指定值。
例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ?, 其中最后一位只能用?,而不能使用*,如果使用*表示不管星期几都会触发,实际上并不是这样。
井号(#)
该字符只能在星期字段中使用,表示当月某个工作日。如6#3表示当月的第三个星期五(6表示星期五,#3表示当前的第三个),而4#5表示当月的第五个星期三,假设当月没有第五个星期三,忽略不触发;
斜杠(/)
x/y表达一个等步长序列,x为起始值,y为增量步长值。如在分钟字段中使用0/15,则表示为0,15,30和45秒,而5/15在分钟字段中表示5,20,35,50,你也可以使用*/y,它等同于0/y;
中划线(-)
表达一个范围,如在小时字段中使用"10-12",则表示从10到12点,即10,11,12;
逗号(,)
表达一个指定的列表值,如在星期字段中使用"MON,WED,FRI",则表示星期一,星期三和星期五;
字母(L)
该字符只在日期和星期字段中使用,代表"Last"的意思,但它在两个字段中意思不同。L在日期字段中,表示这个月份的最后一天,如一月的31号,非闰年二月的28号;如果L用在星期中,则表示星期六,等同于7。但是,如果L出现在星期字段里,而且在前面有一个数值X,则表示"这个月的最后X天",例如,6L表示该月的最后星期五;
字母(W)
该字符只能出现在日期字段里,是对前导日期的修饰,表示离该日期最近的工作日。例如15W表示离该月15号最近的工作日,如果该月15号是星期六,则匹配14号星期五;如果15日是星期日,则匹配16号星期一;如果15号是星期二,那结果就是15号星期二。但必须注意关联的匹配日期不能够跨月,如你指定1W,如果1号是星期六,结果匹配的是3号星期一,而非上个月最后的那天。W字符串只能指定单一日期,而不能指定日期范围。
LW组合:在日期字段可以组合使用LW,它的意思是当月的最后一个工作日;
字母(C)
该字符只在日期和星期字段中使用,代表"Calendar"的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。例如5C在日期字段中就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天。
示例
30 * * * * ? |
每半分钟触发任务 |
30 10 * * * ? |
每小时的10分30秒触发任务 |
30 10 1 * * ? |
每天1点10分30秒触发任务 |
30 10 1 20 * ? |
每月20号1点10分30秒触发任务 |
30 10 1 20 10 ? * |
每年10月20号1点10分30秒触发任务 |
30 10 1 20 10 ? 2011 |
2011年10月20号1点10分30秒触发任务 |
30 10 1 ? 10 * 2011 |
2011年10月每天1点10分30秒触发任务 |
30 10 1 ? 10 SUN 2011 |
2011年10月每周日1点10分30秒触发任务 |
15,30,45 * * * * ? |
每15秒,30秒,45秒时触发任务 |
15-45 * * * * ? |
15到45秒内,每秒都触发任务 |
15/5 * * * * ? |
每分钟的每15秒开始触发,每隔5秒触发一次 |
15-30/5 * * * * ? |
每分钟的15秒到30秒之间开始触发,每隔5秒触发一次 |
0 0/3 * * * ? |
每小时的第0分0秒开始,每三分钟触发一次 |
0 15 10 ? * MON-FRI |
星期一到星期五的10点15分0秒触发任务 |
0 15 10 L * ? |
每个月最后一天的10点15分0秒触发任务 |
0 15 10 LW * ? |
每个月最后一个工作日的10点15分0秒触发任务 |
0 15 10 ? * 5L |
每个月最后一个星期四的10点15分0秒触发任务 |
0 15 10 ? * 5#3 |
每个月第三周的星期四的10点15分0秒触发任务 |