Spring中Quartz的Cron配置說明

2021-08-29 17:13:11 字數 2599 閱讀 2463

乙個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" 2023年的每天早上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" 2023年至2023年的每月最後乙個周五的10:15觸發

"0 15 10 ? * 6#3" 每月的第三個周五的10:15觸發

Spring中的Quartz配置

quartz是乙個強大的企業級任務排程框架,spring中繼承並簡化了quartz。下面就看看在spring中怎樣配置quartz。首先我們來寫乙個被排程的類 quartzjob package com.kay.quartz public class quartzjob spring的quartz配...

Spring中的Quartz配置

首先我們來寫乙個被排程的類 package com.kay.quartz public class quartzjob spring的quartz配置檔案 xml version 1.0 encoding utf 8 beans bean id quartzjob class com.kay.qua...

Spring中Quartz的配置

quartz是乙個強大的企業級任務排程框架,spring中繼承並簡化了quartz,下面就看看在spring中怎樣配置quartz 首先我們來寫乙個被排程的類 public class quartzjob spring的配置檔案 work 10,15,20,25,30,35,40,45,50,55 ...