各個字段的含義
名稱 |
是否必須 |
允許值 |
特殊字符 |
秒 |
是 |
0-59 |
, - * / |
分 |
是 |
0-59 |
, - * / |
時 |
是 |
0-23 |
, - * / |
日 |
是 |
1-31 |
, - * ?/ L W C |
月 |
是 |
1-12 或 JAN-DEC |
, - * / |
周 |
是 |
1-7 或 SUN-SAT |
, - * ? / L C # |
年 |
否 |
空 或 1970-2099 |
, - * / |
特殊符號含義
- 星號(*): 可用在所有字段中,表示對應時間域的每一個時刻,例如, 在分鍾字段時,表示“每分鍾”;
- 問號(?): 該字符只在日期和星期字段中使用,它通常指定為“無意義的值”,相當於點位符;
- 減號(-): 表達一個范圍,如在小時字段中使用“10-12”,則表示從10到12點,即10,11,12;
- 逗號(,): 表達一個列表值,如在星期字段中使用“MON,WED,FRI”,則表示星期一,星期三和星期五;
- 斜杠(/): x/y表達一個等步長序列,x為起始值,y為增量步長值。 如在分鍾字段中使用0/15,則表示為0,15,30和45秒,而5/15在分鍾字段中表示5,20,35,50,你也可以使用*/y,它等同於0/y;
- L: 該字符只在日期和星期字段中使用,代表“Last”的意思,但它在兩個字段中意思不同。 L在日期字段中,表示這個月份的最后一天,如一月的31號,非閏年二月的28號;如果L用在星期中,則表示星期六,等同於7。 但是,如果L出現在星期字段里,而且在前面有一個數值X,則表示“這個月的最后X天”,例如,6L表示該月的最后星期五;
- W: 該字符只能出現在日期字段里,是對前導日期的修飾,表示離該日期最近的工作日。 例如15W表示離該月15號最近的工作日,如果該月15號是星期六,則匹配14號星期五;如果15日是星期日,則匹配16號星期一;如果15號是星期二,那結果就是15號星期二。 但必須注意關聯的匹配日期不能夠跨月,如你指定1W,如果1號是星期六,結果匹配的是3號星期一,而非上個月最后的那天。 W字符串只能指定單一日期,而不能指定日期范圍;
- LW組合: 在日期字段可以組合使用LW,它的意思是當月的最后一個工作日;
- 井號(#): 該字符只能在星期字段中使用,表示當月某個工作日。 如6#3表示當月的第三個星期五(6表示星期五,#3表示當前的第三個),而4#5表示當月的第五個星期三,假設當月沒有第五個星期三,忽略不觸發;
- C: 該字符只在日期和星期字段中使用,代表“Calendar”的意思。 它的意思是計划所關聯的日期,如果日期沒有被關聯,則相當於日歷中所有日期。 例如5C在日期字段中就相當於日歷5日以后的第一天。 1C在星期字段中相當於星期日后的第一天。
Cron表達式對特殊字符的大小寫不敏感,對代表星期的縮寫英文大小寫也不敏感。
示例
表示式 |
說明 |
0/20 * * * * ? |
表示每20秒 運行任務 |
0 0 12 * * ? |
每天12點運行 |
0 15 10 ? * * |
每天10:15運行 |
0 15 10 * * ? |
每天10:15運行 |
0 15 10 * * ? * |
每天10:15運行 |
0 15 10 * * ? 2008 |
在2008年的每天10:15運行 |
0 * 14 * * ? |
每天14點到15點之間每分鍾運行一次,開始於14:00,結束於14:59。 |
0 0/5 14 * * ? |
每天14點到15點每5分鍾運行一次,開始於14:00,結束於14:55。 |
0 0/5 14,18 * * ? |
每天14點到15點每5分鍾運行一次,此外每天18點到19點每5鍾也運行一次。 |
0 0-5 14 * * ? |
每天14:00點到14:05,每分鍾運行一次。 |
0 10,44 14 ? 3 WED |
3月每周三的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 2007-2009 |
在2007,2008,2009年每個月的最后一個星期五的10:15分運行。 |
0 15 10 ? * 6#3 |
每月第三個星期五的10:15分運行。 |
參考資料
- Cron表達式生成器 https://www.bejson.com/othertools/cron/
- 在線Cron表達式生成器 https://cron.qqe2.com/
- Cron表達式使用方法 https://cloud.tencent.com/developer/article/1499211
- .NET Core Quartz使用cron表達式實現定時任務 https://www.cjavapy.com/article/129/
- Quartz.NET 3.x Tutorial https://www.quartz-scheduler.net/documentation/quartz-3.x/tutorial