.NET CORE定时任务Quartz。控制台使用Quartz。在某个特定时间点执行定时任务。Cron表达式 电脑版发表于：2021/3/21 11:06 [TOC] ### 基本使用 下载依赖Quartz依赖： ``` <ItemGroup> <PackageReference Include="Quartz" Version="3.3.3" /> </ItemGroup> ``` 创建任务类：输出一个系统时间就行比较简单 ``` public class TestJob : IJob { public Task Execute(IJobExecutionContext context) { return Task.Run(() => { Console.WriteLine(DateTime.Now); }); } } ``` 使用控制台开始调度 ``` static void Main(string[] args) { StdSchedulerFactory schedulerFactory = new StdSchedulerFactory(); IScheduler _scheduler = schedulerFactory.GetScheduler().Result; //创建触发器(也叫时间策略),每10秒执行一次,一直重复 var trigger = TriggerBuilder.Create() .WithSimpleSchedule(x => x.WithIntervalInSeconds(10).RepeatForever()) .Build(); //创建作业实例 //TestJob即我们需要执行的作业 var jobDetail = JobBuilder.Create<TestJob>() .WithIdentity("Test", "Group")//我们给这个作业取了个“Test”的名字，并取了个组名为“Group” .Build(); //将触发器和作业任务绑定到调度器中 _scheduler.ScheduleJob(jobDetail, trigger); //开启调度器 _scheduler.Start(); //注意这种方式编写不能让程序结束，不然控制台运行完程序直接就结束了，定时任务肯定看不到输出了。 Console.ReadLine(); } ``` 输出如下：  **如果只执行一次的话这样即可** WithRepeatCount设置为0 ``` var trigger = TriggerBuilder.Create() .WithSimpleSchedule(x => x.WithIntervalInSeconds(5).WithRepeatCount(0)) .Build(); ``` ### 一次性执行多个任务 ``` /// <summary> /// 定时服务入口 /// </summary> /// <param name="args"></param> static void Main(string[] args) { StdSchedulerFactory schedulerFactory = new StdSchedulerFactory(); Program program = new Program(); //program.DoInitUserVisitCountDay(schedulerFactory); //program.DoArticleTitleToCacheJob(schedulerFactory); program.DoJobs(schedulerFactory); Console.ReadLine(); } ``` ``` public void DoJobs(StdSchedulerFactory schedulerFactory) { Console.WriteLine("开始新的任务了，定义在每天0点2分执行................." + DateTime.Now); IScheduler _scheduler = schedulerFactory.GetScheduler().Result; var triggers = new ReadOnlyCollection<ITrigger>( new List<ITrigger>() { TriggerBuilder.Create() .WithCronSchedule("0/2 * * * * ?") .Build() }); var trigger2 = new ReadOnlyCollection<ITrigger>( new List<ITrigger>() { TriggerBuilder.Create() .WithCronSchedule("0/2 * * * * ?") .Build() }); // 创建作业实例 var initUserVisitCountJob = JobBuilder.Create<InitUserVisitCountDay>() .WithIdentity("InitUserVisitCountDay", "Group") .Build(); // 创建作业实例 var articleTitleToCacheJob = JobBuilder.Create<ArticleTitleToCacheJob>() .WithIdentity("ArticleTitleToCacheJob", "Group") .Build(); // 注意多个任务的triggers不能使用一个，不然经过测试触发不了 var jobAndTriggerMapping = new Dictionary<IJobDetail, IReadOnlyCollection<ITrigger>>(); jobAndTriggerMapping.Add(initUserVisitCountJob, triggers); jobAndTriggerMapping.Add(articleTitleToCacheJob, trigger2); var readOnlyjobAndTriggerMapping = new ReadOnlyDictionary<IJobDetail, IReadOnlyCollection<ITrigger>>(jobAndTriggerMapping); _scheduler.ScheduleJobs(readOnlyjobAndTriggerMapping, true); //开启调度器 _scheduler.Start(); } ``` ### 更多时间策略 **Quartz中有两种触发策略分别是：** Simple Trigger CronTrigger **SimpleTrigger** 可以满足的调度需求是：在具体的时间点执行一次，或者在具体的时间点执行，并且以指定的间隔重复执行，否者只执行具体的次数 tn2>每30秒执行一次，重复5次： ``` var trigger = TriggerBuilder.Create() .WithSimpleSchedule(x => x.WithIntervalInSeconds(30).WithRepeatCount(5)) .Build(); ``` tn2>30分钟以后开始触发，仅执行一次 ``` var trigger = TriggerBuilder.Create() .WithSimpleSchedule() .StartAt(DateTimeOffset.Now.AddMinutes(30)) .Build(); ``` tn2>在22点过3分执行一次，只执行一次。注意这样设置，如果现在时间已经过了22点3分它任务这个定时的时候已经到了会马上执行,要想特定的时间点可以把年月日加上 ``` //在22点过3分执行一次，只执行一次 var trigger = TriggerBuilder.Create() .WithSimpleSchedule() .StartAt(DateBuilder.DateOf(22, 3, 0)) .Build(); ``` tn2>在某个特定时间点执行定时任务,比如在2022-9-9早上8点执行一次，只执行一次 ``` //在2022-9-9早上8点执行一次，只执行一次 var trigger = TriggerBuilder.Create() .StartAt(DateTimeOffset.Parse("2022-9-9 08:00:00")) .Build(); ``` tn2> 在整点8点执行一次，只执行一次。注意这样设置，如果现在时间已经过了22点3分它任务这个定时的时候已经到了会马上执行 ``` //在整点8点执行一次，只执行一次 var trigger = TriggerBuilder.Create() .WithSimpleSchedule() .StartAt(DateBuilder.DateOf(08,0, 0)) .Build(); ``` tn2>立即触发，每个2小时执行一次，直到10:30:30 ``` var trigger = TriggerBuilder.Create() .WithSimpleSchedule(x => x.WithIntervalInHours(2).RepeatForever()) .EndAt(DateBuilder.DateOf(10, 30, 30)) .Build(); ``` tn2>在下一个小时的整点触发，然后每1小时重复一次 ``` var trigger = TriggerBuilder.Create() .WithSimpleSchedule(x => x.WithIntervalInHours(1).RepeatForever()) .StartAt(DateBuilder.EvenHourDate(null)) .Build(); ``` ### CronTrigger CronTrigger比SimpleTrigger更强大一点，可以基于日历的概念指定任务计划，稍后在介绍。 或者搜索一下Cron表达式生成器就有基本可以涵盖所有场景 **每天上午10:42触发** ``` var trigger = TriggerBuilder.Create() .WithCronSchedule("0 42 10 * * ?") .Build(); //创建作业实例 var jobDetail = JobBuilder.Create<InitUserVisitCountDay>() .WithIdentity("InitUserVisitCountDay", "Group") .Build(); //将触发器和作业任务绑定到调度器中 _scheduler.ScheduleJob(jobDetail, trigger); //开启调度器 _scheduler.Start(); ``` **每天凌晨12点30分执行一次** ``` //每天凌晨12点30分执行一次： var trigger = TriggerBuilder.Create() .WithCronSchedule("0 30 0 * * ?") .Build(); ``` **每天凌晨12点5分执行一次** ``` // 每天凌晨12点5分执行一次： var trigger = TriggerBuilder.Create() .WithCronSchedule("0 5 0 * * ?") .Build(); ``` **表达式解释** >`这些星号由左到右按顺序代表 ：[秒] [分] [小时] [日] [月] [周] [年]` 通配符 `*`： 表示所有值. 例如:在分的字段上设置 “*”,表示每一分钟都会触发。 `?`： 表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作，但不关心是周几，所以需要周位置的那个字段设置为"?" 具体设置为 0 0 0 10 * ? `-`： 表示区间。例如 在小时上设置 “10-12”,表示 10,11,12点都会触发。 `,`： 表示指定多个值，例如在周字段上设置 “MON,WED,FRI” 表示周一，周三和周五触发 `/`：用于递增触发。如在秒上面设置"5/15" 表示从5秒开始，每增15秒触发(5,20,35,50)。在月字段上设置’1/3’所示每月1号开始，每隔三天触发一次。 `L`：表示最后的意思。在日字段设置上，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六，相当于"7"或"SAT"。如果在"L"前加上数字，则表示该数据的最后一个。例如在周字段上设置"6L"这样的格式,则表示“本月最后一个星期五" `W`：表示离指定日期的最近那个工作日(周一至周五). 例如在日字段上设置"15W"，表示离每月15号最近的那个工作日触发。如果15号正好是周六，则找最近的周五(14号)触发, 如果15号是周未，则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五)，则就在该天触发。如果指定格式为 “1W”,它则表示每月1号往后最近的工作日触发。如果1号正是周六，则将在3号下周一触发。(注，“W"前只能设置具体的数字,不允许区间”-"). 小提示 `L`和 `W`可以一组合使用。如果在日字段上设置`LW`,则表示在本月的最后一个工作日触发(一般指发工资 ) **常用示例：** ``` 每天凌晨2点 0 0 2 * * ?和每天隔一小时 0 * */1 * * ? 例1：每隔5秒执行一次：*/5 * * * * ? 例2：每隔5分执行一次：0 */5 * * * ? 在26分、29分、33分执行一次：0 26,29,33 * * * ? 例3：每天半夜12点30分执行一次：0 30 0 * * ? （注意日期域为0不是24） 每天凌晨1点执行一次：0 0 1 * * ? 每天上午10：15执行一次： 0 15 10 ? * * 或 0 15 10 * * ? 或 0 15 10 * * ? * 每天中午十二点执行一次：0 0 12 * * ? 每天14点到14：59分，每1分钟执行一次：0 * 14 * * ? 每天14点到14：05分，每1分钟执行一次：0 0-5 14 * * ? 每天14点到14：55分，每5分钟执行一次：0 0/5 14 * * ? 每天14点到14：55分，和18点到18点55分，每5分钟执行一次：0 0/5 14,18 * * ? 每天18点执行一次：0 0 18 * * ? 每天18点、22点执行一次：0 0 18,22 * * ? 每天7点到23点，每整点执行一次：0 0 7-23 * * ? 每个整点执行一次：0 0 0/1 * * ? ``` **常用示例2：** ``` 常用示例: 0 0 12 * * ? 每天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点59分(整点开始，每隔5分触发) 0 0/5 14,18 * * ? 每天下午的 2点到2点59分(整点开始，每隔5分触发) 每天下午的 18点到18点59分(整点开始，每隔5分触发) 0 0-5 14 * * ? 每天下午的 2点到2点05分每分触发 0 10,44 14 ? 3 WED 3月分每周三下午的 2点10分和2点44分触发 （特殊情况，在一个时间设置里，执行两次或 两次以上的情况） 0 59 2 ? * FRI 每周5凌晨2点59分触发； 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 2002-2005 从2002年到2005年每月最后一周的星期五的10点15分触发 0 15 10 ? * 6#3 每月的第三周的星期五开始触发 0 0 12 1/5 * ? 每月的第一个中午开始每隔5天触发一次 0 11 11 11 11 ? 每年的11月11号 11点11分触发(光棍节) ```
