目
錄
<a href="#_toc465868115">quartz時間表達式入門... 1</a>
<a href="#_toc465868116">quartz時間表達式格式詳解... 2</a>
<a href="#_toc465868117">quartz表達式中的特殊字元... 3</a>
<a href="#_toc465868118">* 星号... 3</a>
<a href="#_toc465868119">? 問号... 3</a>
<a href="#_toc465868120">, 逗号... 4</a>
<a href="#_toc465868121">/ 斜杠... 4</a>
<a href="#_toc465868122">- 中劃線... 5</a>
<a href="#_toc465868123">l 字母... 5</a>
<a href="#_toc465868124">w 字母... 6</a>
<a href="#_toc465868125"># 井号... 6</a>
<a href="#_toc465868126">quartz時間表達式樣例... 7</a>
<a href="#_toc465868127">分鐘的 cron 表達式... 7</a>
<a href="#_toc465868128">天的 cron 表達式... 7</a>
<a href="#_toc465868129">周和月的 cron 表達式... 7</a>
時間格式
分别對應
cron表達式的時間字段除允許設定數值外,還可使用一些特殊的字元,提供清單、範圍、通配符等功能,細說如下:
●星号(*):可用在所有字段中,表示對應時間域的每一個時刻,例如,*在分鐘字段時,表示“每分鐘”;
●問号(?):該字元隻在日期和星期字段中使用,它通常指定為“無意義的值”,相當于點位符;
●減号(-):表達一個範圍,如在小時字段中使用“10-12”,則表示從10到12點,即10,11,12;
●逗号(,):表達一個清單值,如在星期字段中使用“mon,wed,fri”,則表示星期一,星期三和星期五;
●斜杠(/):x/y表達一個等步長序列,x為起始值,y為增量步長值。如在分鐘字段中使用0/15,則表示為0,15,30和45秒,而5/15在分鐘字段中表示5,20,35,50,你也可以使用*/y,它等同于0/y;
quartz cron 表達式的格式十分類似于 linux cron
格式,但還是有少許明顯的差別。差別之一就是 quartz 的格式向下支援到秒級别的計劃,而 linux cron 計劃僅支援至分鐘級。許多我們的觸發計劃要基于秒級遞增的(例如,每45秒),是以這是一個非常好的差異。
在 linux cron 裡,要執行的作業(或者說指令)是存放在 cron 表達式中的,在第六個域位置上。quartz 用 cron 表達式存放執行計劃。引用了 cron 表達式的crontrigger 在計劃的時間裡會與 job 關聯上。
另一個與 linux cron 表達式的不同點是在表達式中支援域的數目。unix 給出五個域(分、時、日、月和周),quartz 提供七個域。下表列出了 quartz cron 表達式支援的七個域。
quartz
cron 表達式支援七個域
名稱
是否必須
允許值
特殊字元
秒
是
0-59
,
- * /
分
時
0-23
日
1-31
- * ? / l w c
月
1-12
或
jan-dec
周
1-7
sun-sat
- * ? / l c #
年
否
空 或 1970-2099
同 linux cron 一樣,quartz cron 表達式支援用特殊字元來建立更為複雜的執行計劃。然而,quartz
在特殊字元的支援上比标準 linux cron 表達式更豐富了。
使用星号(*) 訓示着你想在這個域上包含所有合法的值。例如,在月份域上使用星号意味着每個月都會觸發這個
trigger。
樣例:0 * 17 * * ?
意義:每天從下午5點到下午5:59中的每分鐘激發一次 trigger。它停在下午 5:59 是因為值 17 在小時域上,在下午 6 點時,小時變為 18 了,也就不再理會這個 trigger,直到下一天的下午5點。
在你希望 trigger 在該域的所有有效值上被激發時使用 * 字元。
? 号隻能用在日和周域上,但是不能在這兩個域上同時使用。你可以認為? 字元是 "我并不關心在該域上是什麼值。" 這不同于星号,星号是訓示着該域上的每一個值。? 是說不為該域指定值。
不能同時這兩個域上指定值的理由是難以解釋甚至是難以了解的。基本上,假定同時指定值的話,意義就會變得含混不清了:考慮一下,如果一個表達式在日域上有值11,同時在周域上指定了wed。那麼是要
trigger 僅在每個月的11号,且正好又是星期三那天被激發?還是在每個星期三的11号被激發呢?要去除這種不明确性的辦法就是不能同時在這兩個域上指定值。
隻要記住,假如你為這兩域的其中一個指定了值,那就必須在另一個字值上放一個 ?。
樣例:0 10,44 14 ? 3
web
意義:在三月中的每個星期三的下午
2:10 和 下午 2:44 被觸發。
逗号 (,) 是用來在給某個域上指定一個值清單的。例如,使用值 0,15,30,45 在秒域上意味着每15秒觸發一個 trigger。
樣例:0 0,15,30,45 * *
* ?
意義:每刻鐘觸發一次 trigger。
斜杠 (/) 是用于時間表的遞增的。我們剛剛用了逗号來表示每15分鐘的遞增,但是我們也能寫成這樣0/15。
樣例:0/15 0/30 * * * ?
意義:在整點和半點時每15秒觸發 trigger。
中劃線 (-) 用于指定一個範圍。例如,在小時域上的 3-8 意味着 "3,4,5,6,7 和 8 點。" 域的值不允許回卷,是以像 50-10 這樣的值是不允許的。
樣例:0 45 3-8 ? * *
意義:在上午的3點至上午的8點的45分時觸發 trigger。
l 說明了某域上允許的最後一個值。它僅被日和周域支援。當用在日域上,表示的是在月域上指定的月份的最後一天。例如,當月域上指定了jan 時,在日域上的l會促使
trigger 在1月31号被觸發。假如月域上是sep,那麼 l 會預示着在9月30号觸發。換句話說,就是不管指定了哪個月,都是在相應月份的時最後一天觸發
表達式 0 0 8 l *
? 意義是在每個月最後一天的上午 8:00 觸發
trigger。在月域上的 * 說明是 "每個月"。
當 l 字母用于周域上,訓示着周的最後一天,就是星期六 (或者數字7)。是以如果你需要在每個月的最後一個星期六下午的 11:59 觸發 trigger,你可以用這樣的表達式0 59 23 ? * l。
當使用于周域上,你可以用一個數字與 l 連起來表示月份的最後一個星期 x。例如,表達式 0 0 12 ? * 2l 說的是在每個月的最後一個星期一觸發 trigger。
注意:
不要讓範圍和清單值與 l 連用,雖然你能用星期數(1-7)與 l 連用,但是不允許你用一個範圍值和清單值與 l 連用。這會産生不可預知的結果
w 字元代表着平日 (mon-fri),并且僅能用于日域中。它用來指定離指定日的最近的一個平日。大部分的商業處理都是基于工作周的,是以 w 字元可能是非常重要的。例如,日域中的15w 意味着 "離該月15号的最近一個平日。" 假如15号是星期六,那麼 trigger
會在14号(星期五)觸發,因為星期四比星期一(這個例子中是17号)離15号更近。(譯者unmi注:不會在17号觸發的,如果是15w,可能會是在14号(15号是星期六)或者15号(15号是星期天)觸發,也就是隻能出現在鄰近的一天,如果15号當天為平日直接就會當日執行)。w隻能用在指定的日域為單天,不能是範圍或清單值。
# 字元僅能用于周域中。它用于指定月份中的第幾周的哪一天。例如,如果你指定周域的值為6#3,它意思是某月的第三個周五 (6=星期五,#3意味着月份中的第三周)。另一個例子2#1意思是某月的第一個星期一 (2=星期一,#1意味着月份中的第一周)。注意,假如你指定#5,然而月份中沒有第 5 周,那麼該月不會觸發。
用法
表達式
每天的從 4:00 pm 至 4:59 pm 中的每分鐘觸發
* 16 * * ?
每天的從 10:00 pm 至 10:55 pm 中的每五分鐘觸發
0/5 22 * * ?
每天的從 2:00 至 2:55 pm 和 5:00
pm 至 5:55 pm 之中的每五分鐘觸發
0/5 14,17 * * ?
每天的從 5:00 am 至 5:15 am 中的每分鐘觸發
0-15 5 * * ?
每天的 2:00 am
0 2 * * ?
每天的 2:00 am (另一種寫法)
0 2 ? * *
每天的 12:00 pm (中午)
0 12 * * ?
在 2016 中每天的 10:15 am
15 10 * * ? 2016
在每個周一,二, 三和周四的 10:25 am
25 10 ? * mon-fri
每月15号的 10:00 am
0 10 15 * ?
每月最後一天的 10:15 am
15 10 l * ?
每月最後一個周五的 10:10 am
10 10 ? * 6l
在 2012, 2013, 2014, 和 2015 年中的每月最後一個周五的 10:15 am
15 10 ? * 6l 2012-2015
每月第二個周五的 10:15 am
15 10 ? * 6#2
每月從第一天算起每五天的 12:00 pm (中午)
0 12 1/5 * ?
每一個 11 月 11 号的 11:11
am
11 11 11 11 ?
四月份每個周三的 2:10 pm 和 2:24 pm
10,24 14 ? 4 wed