Cron表達(dá)式的格式
{秒數(shù)} {分鐘} {小時(shí)} {日期} {月份} {星期} {年份(可為空)}
| 字段 | 允許值 | 允許的特殊字符 |
|---|---|---|
| 秒 | 0-59 | , - * / |
| 分 | 0-59 | , - * / |
| 小時(shí) | 0-23 | , - * / |
| 日期 | 1-31 | , - * ? / L W C |
| 月份 | 1-12 或者 JAN-DEC | , - * / |
| 星期 | 1-7 或者 SUN-SAT | , - * ? / L C # |
| 年(可為空) | 留空, 1970-2099 | , - * / |
秒
允許值范圍: 0~59 ,不允許為空值,若值不合法,調(diào)度器將拋出SchedulerException異常
"*" 代表每隔1秒鐘觸發(fā)
"," 代表在指定的秒數(shù)觸發(fā),比如"0,15,45"代表0秒、15秒和45秒時(shí)觸發(fā)任務(wù)
"-" 代表在指定的范圍內(nèi)觸發(fā),比如"25-45"代表從25秒開始觸發(fā)到45秒結(jié)束觸發(fā),每隔1秒觸發(fā)1次
"/" 代表觸發(fā)步進(jìn)(step),"/"前面的值代表初始值("*"等同"0"),后面的值代表偏移量,比如"0/20"或者"*/20"代表從0秒鐘開始,每隔20秒鐘觸發(fā)1次,即0秒觸發(fā)1次,20秒觸發(fā)1次,40秒觸發(fā)1次;"5/20"代表5秒觸發(fā)1次,25秒觸發(fā)1次,45秒觸發(fā)1次;"10-45/20"代表在[10,45]內(nèi)步進(jìn)20秒命中的時(shí)間點(diǎn)觸發(fā),即10秒觸發(fā)1次,30秒觸發(fā)1次
分鐘
允許值范圍: 0~59 ,不允許為空值,若值不合法,調(diào)度器將拋出SchedulerException異常
"*" 代表每隔1分鐘觸發(fā)
"," 代表在指定的分鐘觸發(fā),比如"10,20,40"代表10分鐘、20分鐘和40分鐘時(shí)觸發(fā)任務(wù)
"-" 代表在指定的范圍內(nèi)觸發(fā),比如"5-30"代表從5分鐘開始觸發(fā)到30分鐘結(jié)束觸 發(fā),每隔1分鐘觸發(fā)
"/" 代表觸發(fā)步進(jìn)(step),"/"前面的值代表初始值("*"等同"0"),后面的值代表偏移量,比如"0/25"或者"*/25"代表從0分鐘開始,每隔25分鐘觸發(fā)1次,即0分鐘觸發(fā)1次,第25分鐘觸發(fā)1次,第50分鐘觸發(fā)1次;"5/25"代表5分鐘觸發(fā)1次,30分鐘觸發(fā)1次,55分鐘觸發(fā)1次;"10-45/20"代表在[10,45]內(nèi)步進(jìn)20分鐘命中的時(shí)間點(diǎn)觸發(fā),即10分鐘觸發(fā)1次,30分鐘觸發(fā)1次
小時(shí)
允許值范圍: 0~23 ,不允許為空值,若值不合法,調(diào)度器將拋出SchedulerException異常
"*" 代表每隔1小時(shí)觸發(fā)
"," 代表在指定的時(shí)間點(diǎn)觸發(fā),比如"10,20,23"代表10點(diǎn)鐘、20點(diǎn)鐘和23點(diǎn)觸發(fā)任務(wù)
"-" 代表在指定的時(shí)間段內(nèi)觸發(fā),比如"20-23"代表從20點(diǎn)開始觸發(fā)到23點(diǎn)結(jié)束觸發(fā),每隔1小時(shí)觸發(fā)
"/" 代表觸發(fā)步進(jìn)(step),"/"前面的值代表初始值("*"等同"0"),后面的值代表偏移量,比如"0/1"或者"*/1"代表從0點(diǎn)開始觸發(fā),每隔1小時(shí)觸發(fā)1次;"1/2"代表從1點(diǎn)開始觸發(fā),以后每隔2小時(shí)觸發(fā)一次
日期
允許值范圍: 1~12 (JAN-DEC),不允許為空值,若值不合法,調(diào)度器將拋出SchedulerException異常
"*" 代表每個(gè)月都觸發(fā)
"," 代表在指定的月份觸發(fā),比如"1,6,12"代表1月份、6月份和12月份觸發(fā)任務(wù)
"-" 代表在指定的月份范圍內(nèi)觸發(fā),比如"1-6"代表從1月份開始觸發(fā)到6月份結(jié)束觸發(fā),每隔1個(gè)月觸發(fā)
"/" 代表觸發(fā)步進(jìn)(step),"/"前面的值代表初始值("*"等同"1"),后面的值代表偏移量,比如"1/2"或者"*/2"代表從1月份開始觸發(fā),每隔2個(gè)月觸發(fā)1次;"6/6"代表從6月份開始觸發(fā),以后每隔6個(gè)月觸發(fā)一次;"1-6/12"表達(dá)式意味著每年1月份觸發(fā)
星期
允許值范圍: 1~7 (SUN-SAT),1代表星期天(一星期的第一天),以此類推,7代表星期六(一星期的最后一天),不允許為空值,若值不合法,調(diào)度器將拋出SchedulerException異常
"*" 代表每星期都觸發(fā);
"?" 與{日期}互斥,即意味著若明確指定{日期}觸發(fā),則表示{星期}無意義,以免引起沖突和混亂
"," 代表在指定的星期約定觸發(fā),比如"1,3,5"代表星期天、星期二和星期四觸發(fā)
"-" 代表在指定的星期范圍內(nèi)觸發(fā),比如"2-4"代表從星期一開始觸發(fā)到星期三結(jié)束觸發(fā),每隔1天觸發(fā)
"/" 代表觸發(fā)步進(jìn)(step),"/"前面的值代表初始值("*"等同"1"),后面的值代表偏移量,比如"1/3"或者"*/3"代表從星期天開始觸發(fā),每隔3天觸發(fā)1次;"1-5/2"表達(dá)式意味著在[1,5]范圍內(nèi),每隔2天觸發(fā),即星期天、星期二、星期四觸發(fā)
"L" 如果{星期}占位符如果是"L",即意味著星期的的最后一天觸發(fā),即星期六觸發(fā),L= 7或者 L = SAT,因此,"5L"意味著一個(gè)月的最后一個(gè)星期四觸發(fā)
"#" 用來指定具體的周數(shù),"#"前面代表星期,"#"后面代表本月第幾周,比如"2#2"表示本月第二周的星期一,"5#3"表示本月第三周的星期四,因此,"5L"這種形式只不過是"#"的特殊形式而已
年份
允許值范圍: 1970~2099 ,允許為空,若值不合法,調(diào)度器將拋出SchedulerException異常
"*"代表每年都觸發(fā)
","代表在指定的年份才觸發(fā),比如"2011,2012,2013"代表2011年、2012年和2013年觸發(fā)任務(wù)
"-"代表在指定的年份范圍內(nèi)觸發(fā),比如"2011-2020"代表從2011年開始觸發(fā)到2020年結(jié)束觸發(fā),每隔1年觸發(fā)
"/"代表觸發(fā)步進(jìn)(step),"/"前面的值代表初始值("*"等同"1970"),后面的值代表偏移量,比如"2011/2"或者"*/2"代表從2011年開始觸發(fā),每隔2年觸發(fā)1次
注意:除了{(lán)日期}和{星期}可以使用"?"來實(shí)現(xiàn)互斥,表達(dá)無意義的信息之外,其他占位符都要具有具體的時(shí)間含義,且依賴關(guān)系為:年->月->日期(星期)->小時(shí)->分鐘->秒數(shù)
特殊字符
“*”
“*”字符被用來指定所有的值。如:"*"在分鐘的字段域里表示“每分鐘”。
“?”
“?”字符只在日期域和星期域中使用。它被用來指定“非明確的值”。當(dāng)你需要通過在這兩個(gè)域中的一個(gè)來指定一些東西的時(shí)候,它是有用的??聪旅娴睦幽憔蜁?huì)明白。 月份中的日期和星期中的日期這兩個(gè)元素時(shí)互斥的一起應(yīng)該通過設(shè)置一個(gè)問號(hào)來表明不想設(shè)置那個(gè)字段。
“-”
“-”字符被用來指定一個(gè)范圍。如:“10-12”在小時(shí)域意味著“10點(diǎn)、11點(diǎn)、12點(diǎn)”。
“,”
“,”字符被用來指定另外的值。如:“MON,WED,FRI”在星期域里表示”星期一、星期三、星期五”。
“/”
“/”字符用于指定增量。如:“0/15”在秒域意思是每分鐘的0,15,30和45秒?!?/15”在分鐘域表示每小時(shí)的5,20,35和50。符號(hào)“*”在“/”前面(如:*/10)等價(jià)于0在“/”前面(如:0/10)。記住一條本質(zhì):表達(dá)式的每個(gè)數(shù)值域都是一個(gè)有最大值和最小值的集合,如:秒域和分鐘域的集合是0-59,日期域是1-31,月份域是1-12。字符“/”可以幫助你在每個(gè)字符域中取相應(yīng)的數(shù)值。如:“7/6”在月份域的時(shí)候只有當(dāng)7月的時(shí)候才會(huì)觸發(fā),并不是表示每個(gè)6月。
“L”
L是‘last’的省略寫法可以表示day-of-month和day-of-week域,但在兩個(gè)字段中的意思不同,例如day-of-month域中表示一個(gè)月的最后一天。如果在day-of-week域表示‘7’或者‘SAT’,如果在day-of-week域中前面加上數(shù)字,它表示一個(gè)月的最后幾天,例如‘6L’就表示一個(gè)月的最后一個(gè)星期五。
“W”
字符“W”只允許日期域出現(xiàn)。這個(gè)字符用于指定日期的最近工作日。例如:如果你在日期域中寫 “15W”,表示:這個(gè)月15號(hào)最近的工作日。所以,如果15號(hào)是周六,則任務(wù)會(huì)在14號(hào)觸發(fā)。如果15好是周日,則任務(wù)會(huì)在周一也就是16號(hào)觸發(fā)。如果是在日期域填寫“1W”即使1號(hào)是周六,那么任務(wù)也只會(huì)在下周一,也就是3號(hào)觸發(fā),“W”字符指定的最近工作日是不能夠跨月份的。字符“W”只能配合一個(gè)單獨(dú)的數(shù)值使用,不能夠是一個(gè)數(shù)字段,如:1-15W是錯(cuò)誤的。
“L”和“W”可以在日期域中聯(lián)合使用,LW表示這個(gè)月最后一周的工作日。
“#”
字符“#”只允許在星期域中出現(xiàn)。這個(gè)字符用于指定本月的某某天。例如:“6#3”表示本月第三周的星期五(6表示星期五,3表示第三周)?!?#1”表示本月第一周的星期一。“4#5”表示第五周的星期三。
“C”
字符“C”允許在日期域和星期域出現(xiàn)。這個(gè)字符依靠一個(gè)指定的“日歷”。也就是說這個(gè)表達(dá)式的值依賴于相關(guān)的“日歷”的計(jì)算結(jié)果,如果沒有“日歷”關(guān)聯(lián),則等價(jià)于所有包含的“日歷”。如:日期域是“5C”表示關(guān)聯(lián)“日歷”中第一天,或者這個(gè)月開始的第一天的后5天。星期域是“1C”表示關(guān)聯(lián)“日歷”中第一天,或者星期的第一天的后1天,也就是周日的后一天(周一)。
表達(dá)式舉例
"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ā)