天天看點

Quartz 的Cron時間設定

一個Cron-表達式是一個由六至七個字段組成由空格分隔的字元串,其中6個字段是必須的而一個是可選的,如下:

字段名     允許的值     允許的特殊字元

秒     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秒"。而 "5/15"則表示"第5, 20, 35, 和 50". 在''/''前加"*"字元相當于指定從0秒開始. 每個字段都有一系列可以開始或結束的數值。對于“秒”和“分”字段來說,其數值範圍為0到59,對于“小時”字段來說其為0到23, 對于“日”字段來說為0到31, 而對于“月”字段來說為1到12。"/"字段僅僅隻是幫助你在允許的數值範圍内從開始"第n"的值。 是以 對于“月”字段來說"7/6"隻是表示7月被開啟而不是“每六個月”, 請注意其中微妙的差别。

''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觸發

"0 15 10 ? * 6L"     每月最後一個周五的10:15觸發

"0 15 10 ? * 6L 2002-2005"     2002年至2005年的每月最後一個周五的10:15觸發

"0 15 10 ? * 6#3"     每月的第三個周五的10:15觸發

原文位址:http://hi.baidu.com/lincongsky/blog/item/4d97250029e61282e950cdad.html