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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,517評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,087評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 177,521評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,493評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,207評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,603評論 1 325
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,624評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,813評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,364評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,110評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,305評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,874評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,532評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,953評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,209評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,033評論 3 396
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,268評論 2 375

推薦閱讀更多精彩內容