.NET CORE定时任务Quartz。控制台使用Quartz。在某个特定时间点执行定时任务。Cron表达式

基本使用

下载依赖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
可以满足的调度需求是：在具体的时间点执行一次，或者在具体的时间点执行，并且以指定的间隔重复执行，否者只执行具体的次数

每30秒执行一次，重复5次：

var trigger = TriggerBuilder.Create()
                .WithSimpleSchedule(x => x.WithIntervalInSeconds(30).WithRepeatCount(5))
                .Build();

30分钟以后开始触发，仅执行一次

var trigger = TriggerBuilder.Create()
                            .WithSimpleSchedule()
                            .StartAt(DateTimeOffset.Now.AddMinutes(30))
                            .Build();

在22点过3分执行一次，只执行一次。注意这样设置，如果现在时间已经过了22点3分它任务这个定时的时候已经到了会马上执行,要想特定的时间点可以把年月日加上

//在22点过3分执行一次，只执行一次
var trigger = TriggerBuilder.Create()
                .WithSimpleSchedule()
                .StartAt(DateBuilder.DateOf(22, 3, 0))
                .Build();

在某个特定时间点执行定时任务,比如在2022-9-9早上8点执行一次，只执行一次

//在2022-9-9早上8点执行一次，只执行一次
var trigger = TriggerBuilder.Create()
                .StartAt(DateTimeOffset.Parse("2022-9-9 08:00:00"))
                .Build();

在整点8点执行一次，只执行一次。注意这样设置，如果现在时间已经过了22点3分它任务这个定时的时候已经到了会马上执行

//在整点8点执行一次，只执行一次
var trigger = TriggerBuilder.Create()
                .WithSimpleSchedule()
                .StartAt(DateBuilder.DateOf(08,0, 0))
                .Build();

立即触发，每个2小时执行一次，直到10:30:30

var trigger = TriggerBuilder.Create()
                            .WithSimpleSchedule(x => x.WithIntervalInHours(2).RepeatForever())
                            .EndAt(DateBuilder.DateOf(10, 30, 30))
                            .Build();

在下一个小时的整点触发，然后每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分触发(光棍节)