.Net6 定时任务开发 Cron解析 TimeCrontab

最近开发一个定时任务程序，用到了Cron表达式解析，推介使用TimeCrontab
Gitee连接：TimeCrontab
.NET 全能 Cron 表达式解析库，支持 Cron 完整特性。

一、我使用了三种表达式

表达式中间用一个空格分隔

1、五位：分 时 天 月 周

var crontab = Crontab.Parse("* * * * *");
var nextOccurrence = crontab.GetNextOccurrence(DateTime.Now);

2、六位：秒 分 时 天 月 周

var crontab = Crontab.Parse("* * * * * *", CronStringFormat.WithSeconds);
var nextOccurrence = crontab.GetNextOccurrence(DateTime.Now);

3、七位：秒 分 时 天 月 周 年

var crontab = Crontab.Parse("* * * * * * *", CronStringFormat.WithSecondsAndYears);
var nextOccurrence = crontab.GetNextOccurrence(DateTime.Now);

获取下次执行时间，类函数

public void GetNextRunTime()
    {
        switch (CronStr.Split(' ').Length)
        {
            case 5:
                // 分 时 天 月 周
                NextRunTime = Crontab.Parse(CronStr).GetNextOccurrence(DateTime.Now);
                break;
            case 6:
                // 秒 分 时 天 月 周
                NextRunTime = Crontab.Parse(CronStr, CronStringFormat.WithSeconds).GetNextOccurrence(DateTime.Now);
                break;
            case 7:
                // 秒 分 时 天 月 周 年
                NextRunTime = Crontab.Parse(CronStr, CronStringFormat.WithSecondsAndYears).GetNextOccurrence(DateTime.Now);
                break;
            default:
                NextRunTime = DateTime.Now.AddYears(100);
                break;
        }
    }

二、Cron表达式使用方法

原文地址

Cron 字段支持

字段	允许值	允许特别符号	格式化
秒	0-59	\* , - /	五位 或 六位
分钟	0-59	\* , - /	ALL
小时	0-23	\* , - /	ALL
天	1-31	\* , - / ? L W	ALL
月份	1-12 or JAN-DEC	\* , - /	ALL
星期	0-6 or SUN-SAT	\* , - / ? L #	ALL
年份	0001–9999	\* , - /	七位

(1) *：表示匹配该域的任意值，假如在 分钟 域使用 *，即表示每分钟都会触发事件。

(2) ?：只能用在 天 和 星期 两个域。它也匹配域的任意值，但实际不会。因为 天 和 星期 会相互影响。例如想在 每月的20日 触发调度，不管20日到底是星期几，则只能使用如下写法：13 13 15 20 * ?, 其中最后一位只能用 ?，而不能使用 *，如果使用 * 表示不管星期几都会触发，实际上并不是这样。

(3) -：表示范围，例如在 分钟 域使用 5-20，表示从 5分 到20分钟 每分钟触发一次。

(4) /：表示起始时间开始触发，然后每隔固定时间触发一次，例如在 分钟 域使用 5/20，则意味着 5分钟 触发一次，而 25，45 等分别触发一次。

(5) ,：表示列出枚举值。例如：在 分钟 域使用 5,20，则意味着在 第5 和 第20分钟 分别触发一次。

(6) L：表示最后，只能出现在 星期 和 月份 域，如果在 星期 域使用 5L，意味着在 最后的一个星期四 触发。

(7) W：表示有效工作日(周一到周五),只能出现在 天 域，系统将在离指定日期的最近的有效工作日触发事件。例如：在 天 使用 5W，如果 5日是星期六，则将在最近的工作日：星期五，即 4日 触发。如果 5日是星期天，则在6日(周一)触发；如果 5日在星期一到星期五中的一天，则就在 5日 触发。另外一点，W 的最近寻找不会跨过月份。

(8) LW：这两个字符可以连用，表示在某个月最后一个工作日，即最后一个非周六周末的日期。

(9) #：用于确定每个月第几个星期几，只能出现在 星期 域。例如在 4#2，表示某月的第二个星期三。