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”表示本月第一周的星期一?!?#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觸發