http://space.itpub.net/183473/viewspace-434672
2 Quartz Cron 觸發器 Cron Expression 的格式
http://www.iteye.com/topic/582119
一 Cron Expression 的格式
Quartz的cronExpression見官網文檔說明:
http://www.docjar.com/docs/api/org/quartz/CronExpression.html
圖片如下:
cronExpression配置說明如圖
Quartz cron 表達式的格式向下支持到秒級別的計劃,而 UNIX cron 計劃僅支持至分鐘級.
Quartz用cron 表達式存放執行計劃,引用了cron表達式的CronTrigger在計劃的時間裏會與job關聯上.Cron表達式被用來註冊CronTrigger實例的,一個cronExpression表達式有至少6個(也可能是7個)由空格分隔的時間元素.
從左至右,這些元素的定義如下
1.秒(0–59)
2.分鐘(0–59)
3.小時(0–23)
4.月份中的日期(1–31)
5.月份(1–12或JAN–DEC)
6.星期中的日期(1–7或SUN–SAT)
7.年份(1970–2099)
各個時間可用值如下:
秒 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"的值。
“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"則表示"日曆中的第一天或者週日以後"。
對於“月份”字段和“周幾”字段來說合法的字符都不是大小寫敏感的。
例子如下:
每隔5秒執行一次:*/5 * * * * ?
每隔1分鐘執行一次:0 */1 * * * ?
每天23點執行一次:0 0 23 * * ?
每天凌晨1點執行一次:0 0 1 * * ?
每月1號凌晨1點執行一次:0 0 1 1 * ?
每月最後一天23點執行一次:0 0 23 L * ?
每週星期天凌晨1點實行一次:0 0 1 ? * L
在26分、29分、33分執行一次:0 26,29,33 * * * ?
每天的0點、13點、18點、21點都執行一次:0 0 0,13,18,21 * * ?
"0 0 12 * * ?" 每天中午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期間的每1分鐘觸發
"0 0/5 14 * * ?" 在每天下午2點到下午2:55期間的每5分鐘觸發
"0 0/5 14,18 * * ?" 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發
"0 0-5 14 * * ?" 在每天下午2點到下午2:05期間的每1分鐘觸發
"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2: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 2002-2005" 2002年至2005年的每月的最後一個星期五上午10:15觸發
"0 15 10 ? * 6#3" 每月的第三個星期五上午10:15觸發
每天早上6點
0 6 * * *
每兩個小時
0 */2 * * *
晚上11點到早上8點之間每兩個小時,早上八點
0 23-7/2,8 * * *
每個月的4號和每個禮拜的禮拜一到禮拜三的早上11點
0 11 4 * 1-3
1月1日早上4點
0 4 1 1 *
其中月和周的英文取值參見下圖(源於Quartz源碼:CronExpression.java)