定時任務Cron表達式的格式

Cron表達式的格式

{秒數} {分鐘} {小時} {日期} {月份} {星期} {年份(可爲空)}

字段 允許值 允許的特殊字符
0-59 , - * /
0-59 , - * /
小時 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年(可爲空) 留空, 1970-2099 , - * /

允許值範圍: 0~59 ,不允許爲空值,若值不合法,調度器將拋出SchedulerException異常

"*" 代表每隔1秒鐘觸發

"," 代表在指定的秒數觸發,比如"0,15,45"代表0秒、15秒和45秒時觸發任務

"-" 代表在指定的範圍內觸發,比如"25-45"代表從25秒開始觸發到45秒結束觸發,每隔1秒觸發1次

"/" 代表觸發步進(step),"/"前面的值代表初始值("*"等同"0"),後面的值代表偏移量,比如"0/20"或者"*/20"代表從0秒鐘開始,每隔20秒鐘觸發1次,即0秒觸發1次,20秒觸發1次,40秒觸發1次;"5/20"代表5秒觸發1次,25秒觸發1次,45秒觸發1次;"10-45/20"代表在[10,45]內步進20秒命中的時間點觸發,即10秒觸發1次,30秒觸發1次

分鐘

允許值範圍: 0~59 ,不允許爲空值,若值不合法,調度器將拋出SchedulerException異常

"*" 代表每隔1分鐘觸發

"," 代表在指定的分鐘觸發,比如"10,20,40"代表10分鐘、20分鐘和40分鐘時觸發任務

"-" 代表在指定的範圍內觸發,比如"5-30"代表從5分鐘開始觸發到30分鐘結束觸 發,每隔1分鐘觸發

"/" 代表觸發步進(step),"/"前面的值代表初始值("*"等同"0"),後面的值代表偏移量,比如"0/25"或者"*/25"代表從0分鐘開始,每隔25分鐘觸發1次,即0分鐘觸發1次,第25分鐘觸發1次,第50分鐘觸發1次;"5/25"代表5分鐘觸發1次,30分鐘觸發1次,55分鐘觸發1次;"10-45/20"代表在[10,45]內步進20分鐘命中的時間點觸發,即10分鐘觸發1次,30分鐘觸發1次

小時

允許值範圍: 0~23 ,不允許爲空值,若值不合法,調度器將拋出SchedulerException異常

"*" 代表每隔1小時觸發

"," 代表在指定的時間點觸發,比如"10,20,23"代表10點鐘、20點鐘和23點觸發任務

"-" 代表在指定的時間段內觸發,比如"20-23"代表從20點開始觸發到23點結束觸發,每隔1小時觸發

"/" 代表觸發步進(step),"/"前面的值代表初始值("*"等同"0"),後面的值代表偏移量,比如"0/1"或者"*/1"代表從0點開始觸發,每隔1小時觸發1次;"1/2"代表從1點開始觸發,以後每隔2小時觸發一次

日期

允許值範圍: 1~12 (JAN-DEC),不允許爲空值,若值不合法,調度器將拋出SchedulerException異常

"*" 代表每個月都觸發

"," 代表在指定的月份觸發,比如"1,6,12"代表1月份、6月份和12月份觸發任務

"-" 代表在指定的月份範圍內觸發,比如"1-6"代表從1月份開始觸發到6月份結束觸發,每隔1個月觸發

"/" 代表觸發步進(step),"/"前面的值代表初始值("*"等同"1"),後面的值代表偏移量,比如"1/2"或者"*/2"代表從1月份開始觸發,每隔2個月觸發1次;"6/6"代表從6月份開始觸發,以後每隔6個月觸發一次;"1-6/12"表達式意味着每年1月份觸發

星期

允許值範圍: 1~7 (SUN-SAT),1代表星期天(一星期的第一天),以此類推,7代表星期六(一星期的最後一天),不允許爲空值,若值不合法,調度器將拋出SchedulerException異常

"*" 代表每星期都觸發;

"?" 與{日期}互斥,即意味着若明確指定{日期}觸發,則表示{星期}無意義,以免引起衝突和混亂

"," 代表在指定的星期約定觸發,比如"1,3,5"代表星期天、星期二和星期四觸發

"-" 代表在指定的星期範圍內觸發,比如"2-4"代表從星期一開始觸發到星期三結束觸發,每隔1天觸發

"/" 代表觸發步進(step),"/"前面的值代表初始值("*"等同"1"),後面的值代表偏移量,比如"1/3"或者"*/3"代表從星期天開始觸發,每隔3天觸發1次;"1-5/2"表達式意味着在[1,5]範圍內,每隔2天觸發,即星期天、星期二、星期四觸發

"L" 如果{星期}佔位符如果是"L",即意味着星期的的最後一天觸發,即星期六觸發,L= 7或者 L = SAT,因此,"5L"意味着一個月的最後一個星期四觸發

"#" 用來指定具體的週數,"#"前面代表星期,"#"後面代表本月第幾周,比如"2#2"表示本月第二週的星期一,"5#3"表示本月第三週的星期四,因此,"5L"這種形式只不過是"#"的特殊形式而已

年份

允許值範圍: 1970~2099 ,允許爲空,若值不合法,調度器將拋出SchedulerException異常

"*"代表每年都觸發

","代表在指定的年份才觸發,比如"2011,2012,2013"代表2011年、2012年和2013年觸發任務

"-"代表在指定的年份範圍內觸發,比如"2011-2020"代表從2011年開始觸發到2020年結束觸發,每隔1年觸發

"/"代表觸發步進(step),"/"前面的值代表初始值("*"等同"1970"),後面的值代表偏移量,比如"2011/2"或者"*/2"代表從2011年開始觸發,每隔2年觸發1次

注意:除了{日期}和{星期}可以使用"?"來實現互斥,表達無意義的信息之外,其他佔位符都要具有具體的時間含義,且依賴關係爲:年->月->日期(星期)->小時->分鐘->秒數

特殊字符

“*”

“*”字符被用來指定所有的值。如:"*"在分鐘的字段域裏表示“每分鐘”。

“?”

“?”字符只在日期域和星期域中使用。它被用來指定“非明確的值”。當你需要通過在這兩個域中的一個來指定一些東西的時候,它是有用的。看下面的例子你就會明白。 月份中的日期和星期中的日期這兩個元素時互斥的一起應該通過設置一個問號來表明不想設置那個字段。

“-”

“-”字符被用來指定一個範圍。如:“10-12”在小時域意味着“10點、11點、12點”。

“,”

“,”字符被用來指定另外的值。如:“MON,WED,FRI”在星期域裏表示”星期一、星期三、星期五”。

“/”

“/”字符用於指定增量。如:“0/15”在秒域意思是每分鐘的0,15,30和45秒。“5/15”在分鐘域表示每小時的5,20,35和50。符號“*”在“/”前面(如:*/10)等價於0在“/”前面(如:0/10)。記住一條本質:表達式的每個數值域都是一個有最大值和最小值的集合,如:秒域和分鐘域的集合是0-59,日期域是1-31,月份域是1-12。字符“/”可以幫助你在每個字符域中取相應的數值。如:“7/6”在月份域的時候只有當7月的時候纔會觸發,並不是表示每個6月。

“L”

L是‘last’的省略寫法可以表示day-of-month和day-of-week域,但在兩個字段中的意思不同,例如day-of-month域中表示一個月的最後一天。如果在day-of-week域表示‘7’或者‘SAT’,如果在day-of-week域中前面加上數字,它表示一個月的最後幾天,例如‘6L’就表示一個月的最後一個星期五。

“W”

字符“W”只允許日期域出現。這個字符用於指定日期的最近工作日。例如:如果你在日期域中寫 “15W”,表示:這個月15號最近的工作日。所以,如果15號是週六,則任務會在14號觸發。如果15好是週日,則任務會在週一也就是16號觸發。如果是在日期域填寫“1W”即使1號是週六,那麼任務也只會在下週一,也就是3號觸發,“W”字符指定的最近工作日是不能夠跨月份的。字符“W”只能配合一個單獨的數值使用,不能夠是一個數字段,如:1-15W是錯誤的。

“L”和“W”可以在日期域中聯合使用,LW表示這個月最後一週的工作日。

“#”

字符“#”只允許在星期域中出現。這個字符用於指定本月的某某天。例如:“6#3”表示本月第三週的星期五(6表示星期五,3表示第三週)。“2#1”表示本月第一週的星期一。“4#5”表示第五週的星期三。

“C”

字符“C”允許在日期域和星期域出現。這個字符依靠一個指定的“日曆”。也就是說這個表達式的值依賴於相關的“日曆”的計算結果,如果沒有“日曆”關聯,則等價於所有包含的“日曆”。如:日期域是“5C”表示關聯“日曆”中第一天,或者這個月開始的第一天的後5天。星期域是“1C”表示關聯“日曆”中第一天,或者星期的第一天的後1天,也就是週日的後一天(週一)。

表達式舉例

"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觸發

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章