天天看點

任務排程SchedulerX系列之QuartZ時間表達式文法與樣例說明 Quartz時間表達式入門

目  

<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

繼續閱讀