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

如果你需要像日历那样按日程来触发任务，而不是像SimpleTrigger 那样每隔特定的间隔时间触发，CronTriggers通常比SimpleTrigger更有用。 <?XML:NAMESPACE PREFIX = O />

使用CronTrigger，你可以指定诸如“每个周五中午”，或者“每个工作日的9:<?XML:NAMESPACE PREFIX = ST1 /><chmetcnv w:st="on" unitname="”" sourcevalue="30" hasspace="False" negative="False" numbertype="1" tcsc="0">30<span style="mso-bidi-font-family: 宋体; mso-ascii-font-family: 宋体">”</span></chmetcnv>或者“从每个周一、周三、周五的上午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：<chmetcnv w:st="on" unitname="”" sourcevalue="0" hasspace="False" negative="False" numbertype="1" tcsc="0"><span lang="EN-US" style="COLOR: windowtext; FONT-FAMILY: Verdana; mso-bidi-font-family: Verdana">00</span><span lang="EN-US" style="COLOR: windowtext; FONT-FAMILY: Verdana; mso-ascii-font-family: 宋体">”</span></chmetcnv>。

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

通配符（&apos;*&apos;）可以被用来表示域中“每个”可能的值。因此在"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来表示.

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

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

&apos;L&apos;字符可以在day-of-month及day-of-week中使用，这个字符是"last"的简写，但是在两个域中的意义不同。例如，在day-of-month域中的"L"表示这个月的最后一天，即，一月的31日，非闰年的二月的28日。如果它用在day-of-week中，则表示"7"或者"SAT"。但是如果在day-of-week域中，这个字符跟在别的值后面，则表示"当月的最后的周XXX"。例如："<chmetcnv w:st="on" unitname="l" sourcevalue="6" hasspace="False" negative="False" numbertype="1" tcsc="0">6L</chmetcnv>" 或者 "FRIL"都表示本月的最后一个周五。当使用&apos;L&apos;选项时，最重要的是不要指定列表或者值范围，否则会导致混乱。

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

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

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

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

CronTrigger

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

"0 0/5 * * * ?" CronTrigger

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

"10 0/5 * * * ?" CronTrigger

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

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

例4 – 在每个月的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分钟触发一次。这个解决方案就是创建两个触发器，两个触发器都运行相同的任务。