cronExpression介紹 (轉)
阿新 • • 發佈:2019-02-04
一個Cron-表示式是一個由六至七個欄位組成由空格分隔的字串,其中6個欄位是必須的而一個是可選的,如下:
欄位名
允許的值
允許的特殊字元
秒
0-59
, - * /
分
0-59
, - * /
小時
0-23
, - * /
日
1-31
, - * ? / L W C
月
1-12 or JAN-DEC
, - * /
周幾
1-7 or SUN-SAT
, - * ? / L C #
年 (可選欄位)
empty, 1970-2099
, - * /
'*' 字元可以用於所有欄位,在“分”欄位中設為"*"表示"每一分鐘"的含義。
'?' 字元可以用在“日”和“周幾”欄位. 它用來指定 '不明確的值'. 這在你需要指定這兩個欄位中的某一個值而不是另外一個的時候會被用到。在後面的例子中可以看到其含義。
'-' 字元被用來指定一個值的範圍,比如在“小時”欄位中設為"10-12"表示"10點到12點".
',' 字元指定數個值。比如在“周幾”欄位中設為"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".
'/' 字元用來指定一個值的的增加幅度. 比如在“秒”欄位中設定為"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"則表示"第5, 20, 35, 和 50". 在'/'前加"*"字元相當於指定從0秒開始. 每個欄位都有一系列可以開始或結束的數值。對於“秒”和“分”欄位來說,其數值範圍為0到59,對於“小時”欄位來說其為0到23, 對於“日”欄位來說為0到31, 而對於“月”欄位來說為1到12。"/"欄位僅僅只是幫助你在允許的數值範圍內從開始"第n"的值。 因此對於“月”欄位來說"7/6"只是表示7月被開啟而不是“每六個月”, 請注意其中微妙的差別。
'L'字元可 用在“日”和“周幾”這兩個欄位。它是"last"的縮寫, 但是在這兩個欄位中有不同的含義。例如,“日”欄位中的"L"表示"一個月中的最後一天" —— 對於一月就是31號對於二月來說就是28號(非閏年)。而在“周幾”欄位中, 它簡單的表示"7" or "SAT",但是如果在“周幾”欄位中使用時跟在某個數字之後, 它表示"該月最後一個星期×" —— 比如"6L"表示"該月最後一個週五"。當使用'L'選項時,指定確定的列表或者範圍非常重要,否則你會被結果搞糊塗的。
'W' 可用於“日”欄位。用來指定歷給定日期最近的工作日(週一到週五) 。比如你將“日”欄位設為"15W",意為: "離該月15號最近的工作日"。因此如果15號為週六,觸發器會在14號即週五呼叫。如果15號為週日, 觸發器會在16號也就是週一觸發。如果15號為週二,那麼當天就會觸發。然而如果你將“日”欄位設為"1W", 而一號又是週六, 觸發器會於下週一也就是當月的3號觸發,因為它不會越過當月的值的範圍邊界。'W'字元只能用於“日”欄位的值為單獨的一天而不是一系列值的時候。
'L'和'W'可以組合用於“日”欄位表示為'LW',意為"該月最後一個工作日"。
'#' 字元可用於“周幾”欄位。該字元表示“該月第幾個周×”,比如"6#3"表示該月第三個週五( 6表示週五而"#3"該月第三個)。再比如: "2#1" = 表示該月第一個週一而 "4#5" = 該月第五個週三。注意如果你指定"#5"該月沒有第五個“周×”,該月是不會觸發的。
'C' 字元可用於“日”和“周幾”欄位,它是"calendar"的縮寫。它表示為基於相關的日曆所計算出的值(如果有的話)。如果沒有關聯的日曆, 那它等同於包含全部日曆。“日”欄位值為"5C"表示"日曆中的第一天或者5號以後",“周幾”欄位值為"1C"則表示"日曆中的第一天或者週日以後"。
對於“月份”欄位和“周幾”欄位來說合法的字元都不是大小寫敏感的。
下面是一些完整的例子:
表示式
含義
"0 0 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分每分鐘一次觸發
"0 0/5 14 * * ?"
每天從下午2點開始到2:55分結束每5分鐘一次觸發
"0 0/5 14,18 * * ?"
每天的下午2點至2:55和6點至6點55分兩個時間段內每5分鐘一次觸發
"0 0-5 14 * * ?"
每天14:00至14:05每分鐘一次觸發
"0 10,44 14 ? 3 WED"
三月的每週三的14:10和14: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"
每月最後一個週五的10:15觸發
"0 15 10 ? * 6L 2002-2005"
2002年至2005年的每月最後一個週五的10:15觸發
"0 15 10 ? * 6#3"
每月的第三個週五的10:15觸發
cronExpression介紹
欄位名
允許的值
允許的特殊字元
秒
0-59
, - * /
分
0-59
, - * /
小時
0-23
, - * /
日
1-31
, - * ? / L W C
月
1-12 or JAN-DEC
, - * /
周幾
1-7 or SUN-SAT
, - * ? / L C #
年 (可選欄位)
empty, 1970-2099
, - * /
'*' 字元可以用於所有欄位,在“分”欄位中設為"*"表示"每一分鐘"的含義。
'?' 字元可以用在“日”和“周幾”欄位. 它用來指定 '不明確的值'. 這在你需要指定這兩個欄位中的某一個值而不是另外一個的時候會被用到。在後面的例子中可以看到其含義。
'-' 字元被用來指定一個值的範圍,比如在“小時”欄位中設為"10-12"表示"10點到12點".
',' 字元指定數個值。比如在“周幾”欄位中設為"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".
'/' 字元用來指定一個值的的增加幅度. 比如在“秒”欄位中設定為"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"則表示"第5, 20, 35, 和 50". 在'/'前加"*"字元相當於指定從0秒開始. 每個欄位都有一系列可以開始或結束的數值。對於“秒”和“分”欄位來說,其數值範圍為0到59,對於“小時”欄位來說其為0到23, 對於“日”欄位來說為0到31, 而對於“月”欄位來說為1到12。"/"欄位僅僅只是幫助你在允許的數值範圍內從開始"第n"的值。 因此對於“月”欄位來說"7/6"只是表示7月被開啟而不是“每六個月”, 請注意其中微妙的差別。
'L'字元可 用在“日”和“周幾”這兩個欄位。它是"last"的縮寫, 但是在這兩個欄位中有不同的含義。例如,“日”欄位中的"L"表示"一個月中的最後一天" —— 對於一月就是31號對於二月來說就是28號(非閏年)。而在“周幾”欄位中, 它簡單的表示"7" or "SAT",但是如果在“周幾”欄位中使用時跟在某個數字之後, 它表示"該月最後一個星期×" —— 比如"6L"表示"該月最後一個週五"。當使用'L'選項時,指定確定的列表或者範圍非常重要,否則你會被結果搞糊塗的。
'W' 可用於“日”欄位。用來指定歷給定日期最近的工作日(週一到週五) 。比如你將“日”欄位設為"15W",意為: "離該月15號最近的工作日"。因此如果15號為週六,觸發器會在14號即週五呼叫。如果15號為週日, 觸發器會在16號也就是週一觸發。如果15號為週二,那麼當天就會觸發。然而如果你將“日”欄位設為"1W", 而一號又是週六, 觸發器會於下週一也就是當月的3號觸發,因為它不會越過當月的值的範圍邊界。'W'字元只能用於“日”欄位的值為單獨的一天而不是一系列值的時候。
'L'和'W'可以組合用於“日”欄位表示為'LW',意為"該月最後一個工作日"。
'#' 字元可用於“周幾”欄位。該字元表示“該月第幾個周×”,比如"6#3"表示該月第三個週五( 6表示週五而"#3"該月第三個)。再比如: "2#1" = 表示該月第一個週一而 "4#5" = 該月第五個週三。注意如果你指定"#5"該月沒有第五個“周×”,該月是不會觸發的。
'C' 字元可用於“日”和“周幾”欄位,它是"calendar"的縮寫。它表示為基於相關的日曆所計算出的值(如果有的話)。如果沒有關聯的日曆, 那它等同於包含全部日曆。“日”欄位值為"5C"表示"日曆中的第一天或者5號以後",“周幾”欄位值為"1C"則表示"日曆中的第一天或者週日以後"。
對於“月份”欄位和“周幾”欄位來說合法的字元都不是大小寫敏感的。
下面是一些完整的例子:
表示式
含義
"0 0 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分每分鐘一次觸發
"0 0/5 14 * * ?"
每天從下午2點開始到2:55分結束每5分鐘一次觸發
"0 0/5 14,18 * * ?"
每天的下午2點至2:55和6點至6點55分兩個時間段內每5分鐘一次觸發
"0 0-5 14 * * ?"
每天14:00至14:05每分鐘一次觸發
"0 10,44 14 ? 3 WED"
三月的每週三的14:10和14: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"
每月最後一個週五的10:15觸發
"0 15 10 ? * 6L 2002-2005"
2002年至2005年的每月最後一個週五的10:15觸發
"0 15 10 ? * 6#3"
每月的第三個週五的10:15觸發
cronExpression介紹