1、Quartz.NET介紹

Quartz.NET是一個強大、開源、輕量的作業調度框架，你能夠用它來為執行一個作業而創建簡單的或複雜的作業調度。它有很多特征，如：資料庫支持，集群，插件，支持cron-like表達式等等。非常適合在平時的工作中，定時輪詢資料庫同步，定時郵件通知，定時處理數據等。

Quartz.NET允許開發人員根據時間間隔（或天）來調度作業。它實現了作業和觸發器的多對多關係，還能把多個作業與不同的觸發器關聯。整合了 Quartz.NET的應用程式可以重用來自不同事件的作業，還可以為一個事件組合多個作業。

官網：http://www.quartz-scheduler.net/

源碼：https://github.com/quartznet/quartznet

示例：https://www.quartz-scheduler.net/documentation/quartz-3.x/quick-start.html

Quartz.NET是一個強大、開源、輕量的作業調度框架，是 OpenSymphony 的 Quartz API 的.NET移植，用C#改寫，可用於winform和Web應用中。它靈活而不複雜,你能夠用它來為執行一個作業而創建簡單的或複雜的作業調度。Quartz.NET 3.0 已經開始支持 .NET Core/.NET Standard 2.0。

Job 為作業的介面，JobDetail 用來描述 Job 的實現類及其它相關的靜態信息；Trigger 作為作業的定時管理工具，一個 Trigger 只能對應一個作業實例，而一個作業實例可對應多個 Trigger ；Scheduler 做為定時任務容器，它包含了所有觸發器和作業，每個 Scheduler 都存有 JobDetail 和 Trigger
的註冊，一個 Scheduler 中可以註冊多個 JobDetail 和多個 Trigger 。

2、依賴框架

引入框架的方法非常簡單你可以直接用nuget管理包也可以在項目中添加引用。為了滿足不同客戶的需求，本文以最簡單的方式來講解在Visual Studio中如何正確使用Quartz.NET。

2.1、使用Nuget添加使用

2.1.0、創建一個項目

創建一個新項目，可以是ASP.NET MVC、WebForms、Winforms、.NET Core等多種.Net項目，這裡使用的是VS2017，創建了一個控制台應用項目。

要使用Quartz.NET我們需要安裝Quartz.NET包，最簡單的方式就是從Quartz.NET管網下載dll文件引用即可。本文我們使用Nuget進行dll文件的引用與管理。要使用Nuget必須確保已經安裝過，最簡單的方式是通過VS“工具”菜單查看是否有程式包管理控制台，如果有說明已經安裝過，如下圖所示。

如果沒有找到那我們就要進行安裝。

2.1.2、安裝Nuget

新版本的Visual Studio預設情況是安裝了Nuget的，如Visual Studio 2015+，如果沒有安裝，打開VS菜單“工具”->"擴展與更新"。

在擴展與更新中搜索“nuget”，可以新安裝或卸載後升級。

2.1.3、使用nuget安裝Quartz.NET

點擊“工具”->"NuGet包管理器"->“程式包管理器控制台”

輸入安裝包的命令：

Install-Package Quartz

安裝結果如下：

時包管理器中就下載了需要的程式集與相關文件，同時程式中也添加了引用。

3、Quartz.NET應用

假定要實現每隔5秒鐘向控制台記錄當前時間。

因為這是一個控制台應用，我想一啟動時就開始該項工作，這裡我們需要將代碼寫在static void Main(string[] args)方法中。

3.1、定義要執行的任務

定義一個類，實現Quartz.IJob介面，實現方法Execute，TimeJob.cs文件的代碼如下：

using System;
using System.Threading.Tasks;

namespace QuartzTest
{
    using Quartz;

    public class TimeJob : IJob
    {
        /// <summary>
        /// 作業調度定時執行的方法
        /// </summary>
        /// <param name="context"></param>
        /// <returns></returns>
        public async Task Execute(IJobExecutionContext context)
        {
            await Console.Out.WriteLineAsync("Hello QuartzNet..." + DateTime.Now + Environment.NewLine);           
        }
    }
}

3.2、創建一個調度器

調度器負責管理與控制任務的執行，在Main方法中添加如下代碼：

//調度器
IScheduler scheduler;
//調度器工廠
ISchedulerFactory factory;

//創建一個調度器
factory = new StdSchedulerFactory();
scheduler = factory.GetScheduler();
scheduler.Start();

3.3、創建一個任務對象

這個任務對象就是我們將要執行的工作，job1是名稱，group1是組名。
//2、創建一個任務
IJobDetail job = JobBuilder.Create().WithIdentity("job1", "group1").Build();

3.4、創建一個觸發器

觸發器定義了什麼時間任務開始或每隔多久執行一次。

//3、創建一個觸發器
//DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);
ITrigger trigger = TriggerBuilder.Create()
    .WithIdentity("trigger1", "group1")
    .WithCronSchedule("0/5 * * * * ?")     //5秒執行一次
    .Build();

3.5、將任務與觸發器添加到調度器中並執行

//4、將任務與觸發器添加到調度器中
scheduler.ScheduleJob(job, trigger);
//5、開始執行
scheduler.Start();

3.6、運行結果

3.7 Main方法完整代碼

using Quartz;
using Quartz.Impl;
using System;

namespace QuartzTest
{
    class Program
    {
        static void Main(string[] args)
        {
            //1、調度器
            ISchedulerFactory sf = new StdSchedulerFactory();
            IScheduler sched = sf.GetScheduler();
            //2、創建一個任務
            IJobDetail job = JobBuilder.Create<TimeJob>()
              .WithIdentity("job1", "group1")
              .Build();

            //3、創建一個觸發器
            //DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);
            ITrigger trigger = TriggerBuilder.Create()
                .WithIdentity("trigger1", "group1")
                .WithCronSchedule("0/5 * * * * ?")     //5秒執行一次                                                      
                .Build();

            sched.ScheduleJob(job, trigger);
            //啟動任務
            sched.Start();
        }
    }
}

4、Quartz的cron表達式

　Cron表達式是一個字元串，字元串以5或6個空格隔開，分為6或7個域，每一個域代表一個含義，Cron有如下兩種語法格式：

　　（1） Seconds Minutes Hours DayofMonth Month DayofWeek Year

　　（2）Seconds Minutes Hours DayofMonth Month DayofWeek

結構

　　corn從左到右（用空格隔開）：秒 分 小時 月份中的日期 月份 星期中的日期 年份（可為空）

　　例  "0 0 12 ? * WED" 在每星期三下午12:00 執行（年份通常 省略）

Cron各欄位的含義

通配符說明

星號(*)：可用在所有欄位中，表示對應時間域的每一個時刻，例如， 在分鐘欄位時，表示“每分鐘”；

問號(?)：該字元只在日期和星期欄位中使用，它通常指定為“無意義的值”，相當於點位符；

減號(-)：表達一個範圍，如在小時欄位中使用“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 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分運行。

註意：

（1）有些子表達式能包含一些範圍或列表

　　例如：子表達式（天（星期））可以為 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”

“*”字元代表所有可能的值

　　因此，“”在子表達式（月）里表示每個月的含義，“”在子表達式（天（星期））表示星期的每一天

　　“/”字元用來指定數值的增量 
　　例如：在子表達式（分鐘）里的“0/15”表示從第0分鐘開始，每15分鐘 
在子表達式（分鐘）里的“3/20”表示從第3分鐘開始，每20分鐘（它和“3，23，43”）的含義一樣

　　“？”字元僅被用於天（月）和天（星期）兩個子表達式，表示不指定值 
　　當2個子表達式其中之一被指定了值以後，為了避免衝突，需要將另一個子表達式的值設為“？”

　　“L” 字元僅被用於天（月）和天（星期）兩個子表達式，它是單詞“last”的縮寫 
　　但是它在兩個子表達式里的含義是不同的。 
　　在天（月）子表達式中，“L”表示一個月的最後一天 
　　在天（星期）自表達式中，“L”表示一個星期的最後一天，也就是SAT

　　如果在“L”前有具體的內容，它就具有其他的含義了

　　例如：“6L”表示這個月的倒數第６天，“FRIL”表示這個月的最一個星期五 
　　註意：在使用“L”參數時，不要指定列表或範圍，因為這會導致問題

表達式生成器
有很多的cron表達式線上生成器，這裡給大家推薦幾款
http://www.pdtools.net/tools/becron.jsp

或者

http://cron.qqe2.com/

5、其他文章參考

• 微信公眾號開發系列-玩轉微信開發-目錄彙總

• RDIFramework.NET — 基於.NET的快速信息化系統開發框架 — 系列目錄

• RDIFramework.NET ━ .NET快速信息化系統開發框架 ━ 工作流程組件介紹

• RDIFramework.NET框架SOA解決方案（集Windows服務、WinForm形式與IIS形式發佈）-分散式應用

• RDIFramework.NET代碼生成器全新V3.5版本發佈-重大升級

一路走來數個年頭，感謝RDIFramework.NET框架的支持者與使用者，大家可以通過下麵的地址瞭解詳情。

RDIFramework.NET官方網站：http://www.rdiframework.net/

RDIFramework.NET官方博客：http://blog.rdiframework.net/

同時需要說明的，以後的所有技術文章以官方網站為準，歡迎大家收藏！

RDIFramework.NET框架由專業團隊長期打造、一直在更新、一直在升級，請放心使用！

歡迎關註RDIFramework.net框架官方公眾微信（微信號：guosisoft），及時瞭解最新動態。

掃描二維碼立即關註