最近在使用hangfire來(lái)處理定時(shí)執(zhí)行的任務(wù),需要指定一下任務(wù)的執(zhí)行周期.發(fā)現(xiàn)hangfire和Quarz.net一樣使用的是Cron表達(dá)式來(lái)表示執(zhí)行周期.仔細(xì)研究了一下這個(gè)Cron字符串,發(fā)現(xiàn)表達(dá)能力很強(qiáng).
首先推薦一個(gè)Cron表達(dá)式的驗(yàn)證工具
Cron表達(dá)式是一個(gè)固定格式的字符串涡扼,分為6或者7個(gè)域,每個(gè)域以空格分隔:
(7個(gè)域) Seconds Minutes Hours DayofMonth Month DayofWeek Year
(6個(gè)域) Seconds Minutes Hours DayofMonth Month DayofWeek
Seconds/Minutes等就是域,每個(gè)域代表的意思就像英文代表的意思一樣,具體介紹如下:
Seconds/Minutes/Hours域的規(guī)則都一樣,可以接受 "*-/,number"組成,中間不能有空格.
Seconds/Minutes/Hours: 也就是規(guī)定這個(gè)任務(wù)是在那一秒執(zhí)行
** 表示任何一秒都要執(zhí)行
num-num 表示范圍, 如12-15,表示12秒到15秒,每秒執(zhí)行
num/num 前面數(shù)字表示開(kāi)始時(shí)間,后面表示間隔, 如5/20, 表示從第5秒開(kāi)始,每20秒一次,也就是5,25,45各執(zhí)行一次.
num,num,num 表示指定值, 如4,24,25表示第4秒,第24秒,第25秒執(zhí)行.
每一個(gè)域可出現(xiàn)的字符如下:
Seconds:可出現(xiàn)", - * /"四個(gè)字符吃沪,有效范圍為0-59的整數(shù)
Minutes:可出現(xiàn)", - * /"四個(gè)字符票彪,有效范圍為0-59的整數(shù)
Hours:可出現(xiàn)", - * /"四個(gè)字符不狮,有效范圍為0-23的整數(shù)
DayofMonth:可出現(xiàn)", - * / ? L W C"八個(gè)字符,有效范圍為0-31的整數(shù)
Month:可出現(xiàn)", - * /"四個(gè)字符推掸,有效范圍為1-12的整數(shù)或JAN-DEc
DayofWeek:可出現(xiàn)", - * / ? L C #"四個(gè)字符谅畅,有效范圍為1-7的整數(shù)或SUN-SAT兩個(gè)范圍毡泻。1表示星期天芯咧,2表示星期一竹揍, 依次類(lèi)推
Year:可出現(xiàn)", - * /"四個(gè)字符芬位,有效范圍為1970-2099年
每一個(gè)域都使用數(shù)字昧碉,但還可以出現(xiàn)如下特殊字符揽惹,它們的含義是:
(1):表示匹配該域的任意值搪搏,假如在Minutes域使用, 即表示每分鐘都會(huì)觸發(fā)事件。
(2)?:只能用在DayofMonth和DayofWeek兩個(gè)域论颅。它也匹配域的任意值囱嫩,但實(shí)際不會(huì)墨闲。因?yàn)镈ayofMonth和 DayofWeek會(huì)相互影響。例如想在每月的20日觸發(fā)調(diào)度盾鳞,不管20日到底是星期幾雁仲,則只能使用如下寫(xiě)法: 13 13 15 20 * ?, 其中最后一位只能用琐脏?缸兔,而不能使用惰蜜,如果使用表示不管星期幾都會(huì)觸發(fā),實(shí)際上并不是這樣格侯。
(3)-:表示范圍,例如在Minutes域使用5-20撑碴,表示從5分到20分鐘每分鐘觸發(fā)一次
(4)/:表示起始時(shí)間開(kāi)始觸發(fā)朝墩,然后每隔固定時(shí)間觸發(fā)一次收苏,例如在Minutes域使用5/20,則意味著5分鐘觸發(fā)一次,而25排吴,45等分別觸發(fā)一次.
(5),:表示列出枚舉值值懦鼠。例如:在Minutes域使用5,20,則意味著在5和20分每分鐘觸發(fā)一次葛闷。
(6)L:表示最后,只能出現(xiàn)在DayofWeek和DayofMonth域阳仔,如果在DayofWeek域使用5L,意味著在最后的一個(gè)星期四觸發(fā)扣泊。
(7)W: 表示有效工作日(周一到周五),只能出現(xiàn)在DayofMonth域延蟹,系統(tǒng)將在離指定日期的最近的有效工作日觸發(fā)事件。例如:在 DayofMonth使用5W斥杜,如果5日是星期六沥匈,則將在最近的工作日:星期五,即4日觸發(fā)缰儿。如果5日是星期天乖阵,則在6日(周一)觸發(fā)宣赔;如果5日在星期一 到星期五中的一天拉背,則就在5日觸發(fā)椅棺。另外一點(diǎn)齐蔽,W的最近尋找不會(huì)跨過(guò)月份
(8)LW:這兩個(gè)字符可以連用,表示在某個(gè)月最后一個(gè)工作日诱渤,即最后一個(gè)星期五勺美。
(9)#:用于確定每個(gè)月第幾個(gè)星期幾碑韵,只能出現(xiàn)在DayofMonth域。例如在4#2占卧,表示某月的第二個(gè)星期三联喘。
舉幾個(gè)例子:
0 0 2 1 * ? * 表示在每月的1日的凌晨2點(diǎn)調(diào)度任務(wù)
0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15執(zhí)行作業(yè)
0 15 10 ? 6L 2002-2006 表示2002-2006年的每個(gè)月的最后一個(gè)星期五上午10:15執(zhí)行作
一個(gè)cron表達(dá)式有至少6個(gè)(也可能7個(gè))有空格分隔的時(shí)間元素豁遭。
按順序依次為
秒(0~59)
分鐘(0~59)
小時(shí)(0~23)
天(月)(0~31蓖谢,但是你需要考慮你月的天數(shù))
月(0~11)
天(星期)(1~7 1=SUN 或 SUN,MON蜈抓,TUE沟使,WED渊跋,THU着倾,F(xiàn)RI卡者,SAT)
年份(1970-2099)
其中每個(gè)元素可以是一個(gè)值(如6),一個(gè)連續(xù)區(qū)間(9-12),一個(gè)間隔時(shí)間(8-18/4)(/表示每隔4小時(shí)),一個(gè)列表(1,3,5),通配符崇决。由于"月份中的日期"和"星期中的日期"這兩個(gè)元素互斥的,必須要對(duì)其中一個(gè)設(shè)置?
0 0 10,14,16 * * ? 每天上午10點(diǎn)恒傻,下午2點(diǎn)建邓,4點(diǎn)
0 0/30 9-17 * * ? 朝九晚五工作時(shí)間內(nèi)每半小時(shí)
0 0 12 ? * WED 表示每個(gè)星期三中午12點(diǎn)
"0 0 12 * * ?" 每天中午12點(diǎn)觸發(fā)
"0 15 10 ? * *" 每天上午10:15觸發(fā)
"0 15 10 * * ?" 每天上午10:15觸發(fā)
"0 15 10 * * ? *" 每天上午10:15觸發(fā)
"0 15 10 * * ? 2005" 2005年的每天上午10:15觸發(fā)
"0 * 14 * * ?" 在每天下午2點(diǎn)到下午2:59期間的每1分鐘觸發(fā)
"0 0/5 14 * * ?" 在每天下午2點(diǎn)到下午2:55期間的每5分鐘觸發(fā)
"0 0/5 14,18 * * ?" 在每天下午2點(diǎn)到2:55期間和下午6點(diǎn)到6:55期間的每5分鐘觸發(fā)
"0 0-5 14 * * ?" 在每天下午2點(diǎn)到下午2:05期間的每1分鐘觸發(fā)
"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44觸發(fā)
"0 15 10 ? * MON-FRI" 周一至周五的上午10:15觸發(fā)
"0 15 10 15 * ?" 每月15日上午10:15觸發(fā)
"0 15 10 L * ?" 每月最后一日的上午10:15觸發(fā)
"0 15 10 ? * 6L" 每月的最后一個(gè)星期五上午10:15觸發(fā)
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最后一個(gè)星期五上午10:15觸發(fā)
"0 15 10 ? * 6#3" 每月的第三個(gè)星期五上午10:15觸發(fā)
有些子表達(dá)式能包含一些范圍或列表
例如:子表達(dá)式(天(星期))可以為 “MON-FRI”官边,“MON注簿,WED,F(xiàn)RI”诡渴,“MON-WED,SAT”
“*”字符代表所有可能的值
因此玩徊,“”在子表達(dá)式(月)里表示每個(gè)月的含義,“”在子表達(dá)式(天(星期))表示星期的每一天
“/”字符用來(lái)指定數(shù)值的增量
例如:在子表達(dá)式(分鐘)里的“0/15”表示從第0分鐘開(kāi)始泣棋,每15分鐘
在子表達(dá)式(分鐘)里的“3/20”表示從第3分鐘開(kāi)始,每20分鐘(它和“3潭辈,23澈吨,43”)的含義一樣
“?”字符僅被用于天(月)和天(星期)兩個(gè)子表達(dá)式修赞,表示不指定值
當(dāng)2個(gè)子表達(dá)式其中之一被指定了值以后柏副,為了避免沖突,需要將另一個(gè)子表達(dá)式的值設(shè)為“割择?”
“L” 字符僅被用于天(月)和天(星期)兩個(gè)子表達(dá)式荔泳,它是單詞“l(fā)ast”的縮寫(xiě)
但是它在兩個(gè)子表達(dá)式里的含義是不同的玛歌。
在天(月)子表達(dá)式中,“L”表示一個(gè)月的最后一天
在天(星期)自表達(dá)式中慨飘,“L”表示一個(gè)星期的最后一天译荞,也就是SAT
如果在“L”前有具體的內(nèi)容吞歼,它就具有其他的含義了
例如:“6L”表示這個(gè)月的倒數(shù)第6天,“FRIL”表示這個(gè)月的最一個(gè)星期五
注意:在使用“L”參數(shù)時(shí)稽坤,不要指定列表或范圍尿褪,因?yàn)檫@會(huì)導(dǎo)致問(wèn)題
字段 允許值 允許的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小時(shí) 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年(可選) 留空, 1970-2099 , - * /
2)Cron表達(dá)式范例:
每隔5秒執(zhí)行一次:*/5 * * * * ?
每隔1分鐘執(zhí)行一次:0 */1 * * * ?
每天23點(diǎn)執(zhí)行一次:0 0 23 * * ?
每天凌晨1點(diǎn)執(zhí)行一次:0 0 1 * * ?
每月1號(hào)凌晨1點(diǎn)執(zhí)行一次:0 0 1 1 * ?
每月最后一天23點(diǎn)執(zhí)行一次:0 0 23 L * ?
每周星期天凌晨1點(diǎn)實(shí)行一次:0 0 1 ? * L
在26分杖玲、29分摆马、33分執(zhí)行一次:0 26,29,33 * * * ?
每天的0點(diǎn)鸿吆、13點(diǎn)惩淳、18點(diǎn)、21點(diǎn)都執(zhí)行一次:0 0 0,13,18,21 * * ?