.NET 全能 Cron 表达式解析库，支持 Cron 所有特性

最新推荐文章于 2024-05-25 08:00:00 发布

dotNET跨平台

最新推荐文章于 2024-05-25 08:00:00 发布

阅读量106

点赞数

文章标签： java 开发语言

原文链接：https://mp.weixin.qq.com/s?__biz=MzAwNTMxMzg1MA==&mid=2654098995&idx=4&sn=3a490d30511d7956d32d2f9a21b1d754&chksm=81f9fbfdf7d5ae84002e2384b17cf26740b56cae3b0efbffb77b2b821880aa1bb6e6ade22c78&scene=126&sessionid=0

版权

本文简介

本文将为你介绍一款在 .NET 环境下功能全面的 Cron 表达式解析库——TimeCrontab。这个库不仅支持 Cron 的所有特性，还提供了易于使用的 API，帮助开发者轻松构建和管理定时任务。无论你是开发 Web 应用、后台服务还是桌面程序，TimeCrontab 都能满足你的需求，让你的定时任务更加高效和可靠。

在软件开发中，定时任务扮演着非常重要的角色。它们可以在特定的时间或周期性地执行一些操作，如发送邮件、清理缓存、更新数据等。而在 .NET 环境中，Cron 表达式是一种非常流行的定时任务配置方式。Cron 表达式具有简单易懂、功能强大的特点，可以帮助开发者快速地配置和管理定时任务。

然而，要在 .NET 环境下实现 Cron 表达式的解析和执行，往往需要花费一定的时间和精力。幸运的是，现在有一款名为 TimeCrontab 的全能 Cron 表达式解析库，可以大大简化这一过程。

TimeCrontab 是一款开源的 .NET 库，它提供了对 Cron 表达式的全面支持，包括分钟、小时、日期、月份和星期等各个字段的解析和执行。同时，TimeCrontab 还提供了一些额外的功能，如表达式的验证、表达式的格式化以及表达式的转换等。

使用 TimeCrontab，你可以轻松地构建和管理定时任务。首先，你需要安装 TimeCrontab 库到你的项目中。然后，你可以使用库提供的 API 来创建和管理 Cron 表达式。这些 API 简单易用，即使是没有接触过 Cron 表达式的开发者也能快速上手。

除了易于使用外，TimeCrontab 还具有高度的灵活性和可扩展性。你可以根据自己的需求定制定时任务的执行策略，如并发执行、串行执行等。同时，TimeCrontab 还支持与其他 .NET 框架和库的集成，如 ASP.NET、Quartz.NET 等，使你的定时任务更加高效和可靠。

特性

• 支持 Cron 所有特性
• 超高性能
• 易拓展
• 很小，仅 4KB
• 无第三方依赖
• 跨平台
• 高质量代码和良好单元测试
• 支持 .NET Framework 3.5+ 及后续版本

安装

Install-Package TimeCrontab

dotnet add package TimeCrontab

快速入门

我们在主页上有不少例子，这是让您入门的第一个：

常规格式：分时天月周

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

支持年份：分时天月周年

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

支持秒数：秒分时天月周

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

支持秒和年：秒分时天月周年

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

获取休眠差实现简单定时任务

// 阻塞方式
var crontab = Crontab.Parse("* * * * * *", CronStringFormat.WithSeconds);
while(true)
{
    Thread.Sleep(crontab.GetSleepMilliseconds(DateTime.Now));
    Console.WriteLine(DateTime.Now.ToString("G"));
}

// 无阻塞方式
var crontab = Crontab.Parse("* * * * * *", CronStringFormat.WithSeconds);
Task.Factory.StartNew(async () =>
{
    while (true)
    {
        await Task.Delay(crontab.GetSleepMilliseconds(DateTime.Now));
        Console.WriteLine(DateTime.Now.ToString("G"));
    }
}, TaskCreationOptions.LongRunning);

BackgroundService 实现简单定时任务

using TimeCrontab;

namespace WorkerService;

public class Worker : BackgroundService
{
    private readonly ILogger<Worker> _logger;

    private readonly Crontab _crontab;

    public Worker(ILogger<Worker> logger)
    {
        _logger = logger;
        _crontab = Crontab.Parse("* * * * * *", CronStringFormat.WithSeconds);
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            var taskFactory = new TaskFactory(System.Threading.Tasks.TaskScheduler.Current);

            await taskFactory.StartNew(async () =>
            {
                // 你的业务代码写到这里面

                _logger.LogInformation("Worker running at: {time}", DateTime.Now);

                await Task.CompletedTask;
            }, stoppingToken);

            await Task.Delay(_crontab.GetSleepMilliseconds(DateTime.Now), stoppingToken);
        }
    }
}