Quartz Cron Expression 網上收集的資料 備忘:
一個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觸發
---------------------------------------------
Field Name Mandatory? Allowed Values Allowed Special Characters
Seconds YES 0-59 , - * /
Minutes YES 0-59 , - * /
Hours YES 0-23 , - * /
Day of month YES 1-31 , - * ? / L W C
Month YES 1-12 or JAN-DEC , - * /
Day of week YES 1-7 or SUN-SAT , - * ? / L C #
Year NO empty, 1970-2099 , - * /
項目實例:
second minute hours dayOfMonth month dayOfWeek year
每月 0 0 6 ? * 6#3 ?
每周 59 59 18 ? * 1 ?
自定義 28 47 9 30 7 ? 2006
每月:每個月的第三個星期五的上午6:00:00 觸發
每周:每周的星期日的下午18:59:59 觸發
自定義:2006年7月30日上午9:47:28 觸發
所有星號對應的段位置,都可以出現后面的符號(, - * /)
(? / L C)這些符號可以出現在"一月哪天"和"星期"段位置
(w)只能出現在"一月哪天"段位置
(#)只能出現在"星期"段位置
解釋符號代表的意思:
* 代表任意合法的字段
0 * 17 * * ? :表示在每天的5 PM 到 5:59之間的每一分鐘啟動scheduler
? 表示沒值被指定
如果同時指定"一月哪天"和"星期",可能兩者對應不起來
0 0,15,30,45 * * * ? :表示每刻鐘啟動scheduler
所以推薦用法是其中一個指定值,另一個用?指定
/ 表示時間的增量
0 0/15 * * * ? :表示每刻鐘啟動scheduler
- 表示值的范圍
0 45 3-8 ? * *
L 如果用在"一月哪天"段上,表示一個月的最后一天;如果用在"星期"段上。表示一個星期的最后一天(星期六)
0 0 8 L * ? :表示每個月最后一天的8點啟動scheduler
W 表示最靠近給定時間的一天,(必須是星期一到星期五)
# 例如 6#3表示一個月的第三個星期五