一個(gè)Cron-表達(dá)式是一個(gè)由六至七個(gè)字段組成由空格分隔的字符串,其中6個(gè)字段是必須的而一個(gè)是可選的,如下: 字段名 允許的值 允許的特殊字符 秒 0-59 , - * / 分 0-59 , - * / 小時(shí) 0-23 , - * / 日 1-31 , - * ? / L W C 月 1-12 or JAN-DEC , - * / 周幾 1-7 or SUN-SAT , - * ? / L C # 年 (可選字段) empty, 1970-2099 , - * / '*' 字符可以用于所有字段,在“分”字段中設(shè)為"*"表示"每一分鐘"的含義。 '?' 字符可以用在“日”和“周幾”字段. 它用來(lái)指定 '不明確的值'. 這在你需要指定這兩個(gè)字段中的某一個(gè)值而不是另外一個(gè)的時(shí)候會(huì)被用到。在后面的例子中可以看到其含義。 '-' 字符被用來(lái)指定一個(gè)值的范圍,比如在“小時(shí)”字段中設(shè)為"10-12"表示"10點(diǎn)到12點(diǎn)". ',' 字符指定數(shù)個(gè)值。比如在“周幾”字段中設(shè)為"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday". '/' 字符用來(lái)指定一個(gè)值的的增加幅度. 比如在“秒”字段中設(shè)置為"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"則表示"第5, 20, 35, 和 50". 在'/'前加"*"字符相當(dāng)于指定從0秒開始. 每個(gè)字段都有一系列可以開始或結(jié)束的數(shù)值。對(duì)于“秒”和“分”字段來(lái)說(shuō),其數(shù)值范圍為0到59,對(duì)于“小時(shí)”字段來(lái)說(shuō)其為0到23, 對(duì)于“日”字段來(lái)說(shuō)為0到31, 而對(duì)于“月”字段來(lái)說(shuō)為1到12。"/"字段僅僅只是幫助你在允許的數(shù)值范圍內(nèi)從開始"第n"的值。 因此 對(duì)于“月”字段來(lái)說(shuō)"7/6"只是表示7月被開啟而不是“每六個(gè)月”, 請(qǐng)注意其中微妙的差別。 'L'字符可用在“日”和“周幾”這兩個(gè)字段。它是"last"的縮寫, 但是在這兩個(gè)字段中有不同的含義。例如,“日”字段中的"L"表示"一個(gè)月中的最后一天" —— 對(duì)于一月就是31號(hào)對(duì)于二月來(lái)說(shuō)就是28號(hào)(非閏年)。而在“周幾”字段中, 它簡(jiǎn)單的表示"7" or "SAT",但是如果在“周幾”字段中使用時(shí)跟在某個(gè)數(shù)字之后, 它表示"該月最后一個(gè)星期×" —— 比如"6L"表示"該月最后一個(gè)周五"。當(dāng)使用'L'選項(xiàng)時(shí),指定確定的列表或者范圍非常重要,否則你會(huì)被結(jié)果搞糊涂的。 'W' 可用于“日”字段。用來(lái)指定歷給定日期最近的工作日(周一到周五) 。比如你將“日”字段設(shè)為"15W",意為: "離該月15號(hào)最近的工作日"。因此如果15號(hào)為周六,觸發(fā)器會(huì)在14號(hào)即周五調(diào)用。如果15號(hào)為周日, 觸發(fā)器會(huì)在16號(hào)也就是周一觸發(fā)。如果15號(hào)為周二,那么當(dāng)天就會(huì)觸發(fā)。然而如果你將“日”字段設(shè)為"1W", 而一號(hào)又是周六, 觸發(fā)器會(huì)于下周一也就是當(dāng)月的3號(hào)觸發(fā),因?yàn)樗粫?huì)越過(guò)當(dāng)月的值的范圍邊界。'W'字符只能用于“日”字段的值為單獨(dú)的一天而不是一系列值的時(shí)候。 'L'和'W'可以組合用于“日”字段表示為'LW',意為"該月最后一個(gè)工作日"。 '#' 字符可用于“周幾”字段。該字符表示“該月第幾個(gè)周×”,比如"6#3"表示該月第三個(gè)周五( 6表示周五而"#3"該月第三個(gè))。再比如: "2#1" = 表示該月第一個(gè)周一而 "4#5" = 該月第五個(gè)周三。注意如果你指定"#5"該月沒有第五個(gè)“周×”,該月是不會(huì)觸發(fā)的。 'C' 字符可用于“日”和“周幾”字段,它是"calendar"的縮寫。 它表示為基于相關(guān)的日歷所計(jì)算出的值(如果有的話)。如果沒有關(guān)聯(lián)的日歷, 那它等同于包含全部日歷。“日”字段值為"5C"表示"日歷中的第一天或者5號(hào)以后",“周幾”字段值為"1C"則表示"日歷中的第一天或者周日以后"。 對(duì)于“月份”字段和“周幾”字段來(lái)說(shuō)合法的字符都不是大小寫敏感的。 下面是一些完整的例子: 表達(dá)式 含義 "0 0 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點(diǎn)59分每分鐘一次觸發(fā) "0 0/5 14 * * ?" 每天從下午2點(diǎn)開始到2:55分結(jié)束每5分鐘一次觸發(fā) "0 0/5 14,18 * * ?" 每天的下午2點(diǎn)至2:55和6點(diǎn)至6點(diǎn)55分兩個(gè)時(shí)間段內(nèi)每5分鐘一次觸發(fā) "0 0-5 14 * * ?" 每天14:00至14:05每分鐘一次觸發(fā) "0 10,44 14 ? 3 WED" 三月的每周三的14:10和14:44觸發(fā) "0 15 10 ? * MON-FRI" 每個(gè)周一、周二、周三、周四、周五的10:15觸發(fā) "0 15 10 15 * ?" 每月15號(hào)的10:15觸發(fā) "0 15 10 L * ?" 每月的最后一天的10:15觸發(fā) "0 15 10 ? * 6L" 每月最后一個(gè)周五的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ā) --------------------------------------------- Field Name Mandatory? Allowed Values Allowed Special Characters Seconds YES 0-59 , - * / Minutes YES 0-59 , - * / Hours YES 0-23 , - * / Day of month YES 1-31 , - * ? / L W C Month YES 1-12 or JAN-DEC , - * / Day of week YES 1-7 or SUN-SAT , - * ? / L C # Year NO empty, 1970-2099 , - * / 項(xiàng)目實(shí)例: second minute hours dayOfMonth month dayOfWeek year 每月 0 0 6 ? * 6#3 ? 每周 59 59 18 ? * 1 ? 自定義 28 47 9 30 7 ? 2006 每月:每個(gè)月的第三個(gè)星期五的上午6:00:00 觸發(fā) 每周:每周的星期日的下午18:59:59 觸發(fā) 自定義:2006年7月30日上午9:47:28 觸發(fā) 所有星號(hào)對(duì)應(yīng)的段位置,都可以出現(xiàn)后面的符號(hào)(, - * /) (? / L C)這些符號(hào)可以出現(xiàn)在"一月哪天"和"星期"段位置 (w)只能出現(xiàn)在"一月哪天"段位置 (#)只能出現(xiàn)在"星期"段位置 解釋符號(hào)代表的意思: * 代表任意合法的字段 0 * 17 * * ? :表示在每天的5 PM 到 5:59之間的每一分鐘啟動(dòng)scheduler 表示沒值被指定 如果同時(shí)指定"一月哪天"和"星期",可能兩者對(duì)應(yīng)不起來(lái) 0 0,15,30,45 * * * ? :表示每刻鐘啟動(dòng)scheduler 所以推薦用法是其中一個(gè)指定值,另一個(gè)用?指定 / 表示時(shí)間的增量 0 0/15 * * * ? :表示每刻鐘啟動(dòng)scheduler - 表示值的范圍 0 45 3-8 ? * * L 如果用在"一月哪天"段上,表示一個(gè)月的最后一天;如果用在"星期"段上。表示一個(gè)星期的最后一天(星期六) 0 0 8 L * ? :表示每個(gè)月最后一天的8點(diǎn)啟動(dòng)scheduler W 表示最靠近給定時(shí)間的一天,(必須是星期一到星期五) # 例如 6#3表示一個(gè)月的第三個(gè)星期五 |
|