Quartz.net官方开发指南 第六课 : CronTrigger

如果你需要像日历那样按日程来触发任务，而不是像 SimpleTrigger 那样每隔特定的间隔时间触发， CronTriggers 通常比 SimpleTrigger 更有用。

使用 CronTrigger ，你可以指定诸如 “ 每个周五中午 ” ，或者 “ 每个工作日的 9: 30 ” 或者 “ 从每个周一、周三、周五的上午 9 ： 00 到上午 10 ： 00 之间每隔五分钟 ” 这样日程安排来触发。甚至，象SimpleTrigger一样，CronTrigger也有一个StartTime以指定日程从什么时候开始，也有一个（可选的）EndTime以指定何时日程不再继续。

Cron Expressions ―― Cron 表达式

Cron 表达式被用来配置 CronTrigger 实例。 Cron 表达式是一个由 7 个子表达式组成的字符串。每个子表达式都描述了一个单独的日程细节。这些子表达式用空格分隔，分别表示：

 

  1. Seconds 秒

  2. Minutes 分钟

  3. Hours 小时

  4. Day-of-Month 月中的天

  5. Month 月

  6. Day-of-Week 周中的天

  7. Year (optional field) 年（可选的域）

一个 cron 表达式的例子字符串为 "0 0 12 ? * WED" , 这表示 “ 每周三的中午 12 ： 00 ” 。

单个子表达式可以包含范围或者列表。例如：前面例子中的周中的天这个域（这里是 "WED" ）可以被替换为 "MON-FRI", "MON, WED, FRI" 或者甚至 "MON-WED,SAT" 。

通配符（ '*' ）可以被用来表示域中 “ 每个 ” 可能的值。因此在 "Month" 域中的 * 表示每个月，而在 Day-Of-Week 域中的 * 则表示 “ 周中的每一天 ” 。

所有的域中的值都有特定的合法范围，这些值的合法范围相当明显，例如：秒和分域的合法值为 0 到 59 ，小时的合法范围是 0 到 23 ， Day-of-Month 中值得合法凡范围是 0 到 31 ，但是需要注意不同的月份中的天数不同。月份的合法值是 0 到 11 。或者用字符串 JAN,FEB MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV 及 DEC 来表示。 Days-of-Week 可以用 1 到 7 来表示（ 1= 星期日）或者用字符串 SUN, MON, TUE, WED, THU, FRI 和 SAT 来表示 .

'/' 字符用来表示值的增量，例如 , 如果分钟域中放入 '0/15' ，它表示 “ 每隔 15 分钟，从 0 开始 ” ，如果在份中域中使用 '3/20' ，则表示 “ 小时中每隔 20 分钟，从第 3 分钟开始 ” 或者另外相同的形式就是 '3,23,43' 。

'?' 字符可以用在 day-of-month 及 day-of-week 域中，它用来表示 “ 没有指定值 ” 。这对于需要指定一个或者两个域的值而不需要对其他域进行设置来说相当有用。

'L' 字符可以在 day-of-month 及 day-of-week 中使用，这个字符是 "last" 的简写，但是在两个域中的意义不同。例如，在 day-of-month 域中的 "L" 表示这个月的最后一天，即，一月的 31 日，非闰年的二月的 28 日。如果它用在 day-of-week 中，则表示 "7" 或者 "SAT" 。但是如果在 day-of-week 域中，这个字符跟在别的值后面，则表示 " 当月的最后的周 XXX" 。例如： " 6L " 或者 "FRIL" 都表示本月的最后一个周五。当使用 'L' 选项时，最重要的是不要指定列表或者值范围，否则会导致混乱。

'W' 字符用来指定距离给定日最接近的周几（在 day-of-week 域中指定）。例如：如果你为 day-of-month 域指定为 "15W", 则表示 “ 距离月中 15 号最近的周几 ” 。

'#' 表示表示月中的第几个周几。例如： day-of-week 域中的 "6#3" 或者 "FRI#3" 表示 “ 月中第三个周五 ” 。

下面是一些表达式以及它们的含义 。

Example Cron Expressions ―― Cron 表达式的例子

CronTrigger

例 1 �C 一个简单的每隔 5 分钟触发一次的表达式

"0 0/5 * * * ?" CronTrigger

  例 2 �C 在每分钟的 10 秒后每隔 5 分钟触发一次的表达式 ( 例如 . 10:00:10 am, 10:05:10 等 .) 。

"10 0/5 * * * ?" CronTrigger

例 3 �C 在每个周三和周五的 10 ： 30 ， 11 ： 30 ， 12 ： 30 触发的表达式。

"0 30 10-13 ? * WED,FRI" CronTrigger

例 4 �C 在每个月的 5 号， 20 号的 8 点和 10 点之间每隔半个小时触发一次且不包括 10 点，只是 8 ： 30 ， 9 ： 00 和 9 ： 30 的表达式。

"0 0/30 8-9 5,20 * ?" 注意，对于单独触发器来说，有些日程需求可能过于复杂而不能用表达式表述，例如： 9 ： 00 到 10 ： 00 之间每隔 5 分钟触发一次，下午 1 ： 00 到 10 点每隔 20 分钟触发一次。这个解决方案就是创建两个触发器，两个触发器都运行相同的任务。

自由、创新、研究、探索……