常见的表达式
- 每天12点运行
"0 0 12 * * ?"
- 每15分钟执行一次
"0 0/15 * * * ? *"
Cron 表达式简介
关于 cronExpression 表达式有至少 6 个(也可能是 7 个)由空格分隔的时间元素。从左至右,这些元素的定义如下:
- 秒(0–59)
- 分钟(0–59)
- 小时(0–23)
- 月份中的日期(1–31)
- 月份(1–12 或 JAN–DEC)
- 星期中的日期(1–7 或 SUN–SAT)
- 年份(1970–2099)
0 0 10,14,16 * * ?
每天上午 10 点,下午 2 点和下午 4 点
0 0,15,30,45 * 1-10 * ?
每月前 10 天每隔 15 分钟
30 0 0 1 1 ? 2012
在 2012 年 1 月 1 日午夜过 30 秒时
各个时间可用值如下:
- 秒 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 , - * /
可用值详细分析如下:
| 详细报告 | |
|---|---|
| "*" | 字符可以用于所有字段,在"分"字段中设为"*",表示"每一分钟"的含义。 |
| "?" | 字符可以用在"日"和"周几"字段,它用来指定"不明确的值"。 |
| "-" | 字符被用来指定一个值的范。比如在"小时"字段中设为"10-12",表示"10 点到 12 点"。 |
| "," | 字符指定数个值。 |
| 比如在"周几"字段中设为"MON,WED,FRI",表示"the days Monday, Wednesday, and Friday"。 | |
| "/" | 字符用来指定一个值的的增加幅度。 |
| 比如在"秒"字段中设置为"0/15"表示"第 0, 15, 30,和 45 秒"。 |
"L" —— 字符可用在"日"和"周几"这两个字段。它是"last"的缩写,但是在这两个字段中有不同的含义。
"日"字段中的"L"表示"一个月中的最后一天",对于一月就是 31 号,对于二月来说就是 28 号(非闰年)。
"周几"字段中,它简单的表示"7" or "SAT"。
但是如果在"周几"字段中使用时跟在某个数字之后,它表示"该月最后一个星期×"。
比如"6L"表示"该月最后一个周五"。
当使用"L"选项时,指定确定的列表或者范围非常重要,否则你会被结果搞糊涂的。
"W" —— 可用于"日"字段。用来指定历给定日期最近的工作日(周一到周五)。
比如将"日"字段设为"15W",意为: "离该月 15 号最近的工作日"。
因此如果 15 号为周六,触发器会在 14 号即周五调用。
如果 15 号为周日,触发器会在 16 号也就是周一触发。如果 15 号为周二,那么当天就会触发。
如果"日"字段设为"1W",而一号是周六,会于下周一即当月的 3 号触发,它不会越过当月的值的范围边界。
"W"字符只能用于"日"字段的值为单独的一天而不是一系列值的时候。
"L"和"W"可以组合用于“日”字段表示为'LW',意为"该月最后一个工作日"。
"#" —— 字符可用于"周几"字段。该字符表示"该月第几个周×"。
比如"6#3"表示该月第三个周五( 6 表示周五,而"#3"该月第三个)。
再比如: "2#1" 表示该月第一个周一,而"4#5" 该月第五个周三。
注意如果你指定"#5"该月没有第五个"周×",该月是不会触发的。
"C" —— 字符可用于"日"和"周几"字段,它是"calendar"的缩写。
它表示为基于相关的日历所计算出的值(如果有)。如果没有关联的日历,那它等同于包含全部日历。
"日"字段值为"5C",表示"日历中的第一天或者 5 号以后"。
"周几"字段值为"1C",则表示"日历中的第一天或者周日以后"。
对于"月份"字段和"周几"字段来说合法的字符都不是大小写敏感的。
一些例子:
"0 0 12 * * ?" 每天中午十二点触发
"0 15 10 ? * *" 每天早上 10:15 触发
"0 15 10 * * ?" 每天早上 10:15 触发
"0 15 10 * * ? *" 每天早上 10:15 触发
"0 15 10 * * ? 2005" 2005 年的每天早上 10:15 触发
"0 * 14 * * ?" 每天从下午 2 点开始到 2 点 59 分每分钟一次触发
"0 0/5 14 * * ?" 每天从下午 2 点开始到 2:55 分结束每 5 分钟一次触发
"0 0/5 14,18 * * ?" 每天的下午 2 点至 2:55 和 6 点至 6 点 55 分两个时间段内每 5分钟一次触发
"0 0-5 14 * * ?" 每天 14:00 至 14:05 每分钟一次触发
"0 10,44 14 ? 3 WED" 三月的每周三的 14:10 和 14:44 触发
"0 15 10 ? * MON-FRI" 每个周一、周二、周三、周四、周五的 10:15 触 发
"0 15 10 15 * ?" 每月 15 号的 10:15 触发
"0 15 10 L * ?" 每月的最后一天的 10:15 触发
"0 15 10 ? * 6L" 每月最后一个周五的 10:15