一篇学会cron表达式

1、定义

Cron表达式是一种用于定义定时任务的格式化字符串。它被广泛用于Unix、Linux和类Unix系统中,用于在指定的时间执行预定的任务。Cron表达式由6个字段组成,每个字段通过空格分隔开。

在本文中,我们将学习如何理解和编写Cron表达式。

Cron表达式的格式如下:

javascript 复制代码
* * * * * *  
| | | | | |  
| | | | | +-- 星期(周日=0 或 7)  
| | | | +---- 月份(1-12)  
| | | +------ 日期(1-31)  
| | +-------- 小时(0-23)  
| +---------- 分钟(0-59)  
+------------ 秒(0-59)

每个字段可以使用数字来表示具体的值,也可以使用一些特殊字符来表示范围、递增等。

下面是一些常用的特殊字符:

:代表所有可能的值,例如在小时字段中 表示每一个小时。

?:在日期和星期字段中,表示不指定值。

-:表示范围,例如在小时字段中1-3表示1点到3点。

,:表示列举值,例如在小时字段中1,3,5表示1点、3点和5点。

/:表示递增,例如在分钟字段中*/15表示每15分钟。

下面是一些示例Cron表达式:

1)每分钟的第30秒执行任务:

javascript 复制代码
30 * * * * *

2)每小时的第30分钟执行任务:

javascript 复制代码
* 30 * * * *

3)每天的凌晨1点执行任务:

javascript 复制代码
0 1 * * *

4)每月的第1天的凌晨1点执行任务:

javascript 复制代码
0 1 1 * *

5)每周一的凌晨1点执行任务:

javascript 复制代码
0 1 * * 1

以上只是Cron表达式的一些基本示例,你可以根据自己的需求灵活组合各个字段来定义复杂的定时任务。需要注意的是,Cron表达式的具体语法和支持的特殊字符可能因不同的系统或工具而有所差异,因此在实际使用时最好查阅相关文档进行参考。

2、.NET代码举例

以下是一个使用.NET代码的例子,演示如何创建和执行一个Cron表达式。

首先,你需要安装一个用于解析和执行Cron表达式的.NET库。常用的库是NCrontab和Quartz,你可以通过NuGet包管理器将其添加到你的项目中。

安装完成后,你可以使用以下代码创建一个Cron表达式,并生成一个对应的定时任务。

1)NCrontab

1、安装NCrontab库

2、NCrontabUtil工具类

csharp 复制代码
/// <summary>
/// NCrontab解析Cron表达式
/// 不支持秒级
/// </summary>
public static class NCrontabUtil
{
    /// <summary>
    /// 执行NCrontab解析
    /// </summary>
    /// <param name="cronExpression">Cron表达式</param>
    public static void ExecuteNCrontab(string cronExpression)
    {
        // 解析Cron表达式  
        CrontabSchedule schedule = CrontabSchedule.Parse(cronExpression);

        // 获取当前时间  
        DateTime currentTime = DateTime.Now;

        // 计算下一个执行时间  
        DateTime nextOccurrence = schedule.GetNextOccurrence(currentTime);

        Console.WriteLine("下一个执行时间:" + nextOccurrence.ToString());

        // 在下一个执行时间执行任务  
        // 这里只是简单打印一条消息作为示例任务  
        Action task = () => Console.WriteLine("执行任务...");
        task.Invoke();
    }
}

3、调用

csharp 复制代码
// 创建一个Cron表达式
string cronExpression = "";

// NCrontab 不支持秒级
// 在每小时的第一分钟执行任务。这个表达式具体表示在每小时的第一分钟(例如01:01、02:01、03:01等)触发执行相应的任务
// 其他字段的值使用星号()表示,意味着对应字段的所有可能值都被匹配,即任务在每个小时都会执行
cronExpression = "1 * * * *";
NCrontabUtil.ExecuteNCrontab(cronExpression);

4、结果

2)Quartz(推荐使用,支持6为表达式->支持秒级)

1、安装Quartz库

2、QuartzUtil工具类

csharp 复制代码
/// <summary>
/// Quartz解析Cron表达式
/// 支持秒级
/// </summary>
public static class QuartzUtil
{
    /// <summary>
    /// 执行Quartz解析
    /// </summary>
    /// <param name="cronExpression">Cron表达式</param>
    public async static void ExecuteQuartz(string cronExpression)
    {
        // 创建调度器工厂
        var schedulerFactory = new StdSchedulerFactory();
        // 获取调度器  .ConfigureAwait(false)避免死锁,下同
        var scheduler = await schedulerFactory.GetScheduler().ConfigureAwait(false);
        // 开启调度器
        await scheduler.Start().ConfigureAwait(false);
        // 创建作业
        var job = JobBuilder.Create<MyJob>()
            .WithIdentity("myJob")
            .Build();
        // 创建触发器,并设置CRON表达式
        var trigger = TriggerBuilder.Create()
            .WithIdentity("myTrigger")
            .WithCronSchedule(cronExpression)  
            .Build();

        // 将作业和触发器关联到调度器中
        await scheduler.ScheduleJob(job, trigger).ConfigureAwait(false);

        // 保持主程序的运行,以便调度器持续执行任务  
        Console.WriteLine("Press any key to exit...");
        Console.ReadKey();

        // 关闭调度器
        await scheduler.Shutdown().ConfigureAwait(false);
    }

    // 创建作业类
    public class MyJob : IJob
    {
        public async Task Execute(IJobExecutionContext context)
        {
            // 在这里编写每秒要执行的代码
            if (context.NextFireTimeUtc.HasValue)
            {
                Console.WriteLine("执行任务中...下一次执行任务时间" + context.NextFireTimeUtc.Value.ToLocalTime().DateTime.ToString("yyyy-MM-dd HH:mm:ss"));
            }
            else
            {
                Console.WriteLine("执行任务中...下一次执行任务时间未知");
            }
            await Task.CompletedTask;
        }
    }
}

3、调用

csharp 复制代码
// 创建一个Cron表达式
string cronExpression = "";

// Quartz 支持秒级
// 每秒执行一次的CRON表达式  
cronExpression = "0/1 * * * * ?";
QuartzUtil.ExecuteQuartz(cronExpression);

4、结果

希望本文能帮助你学会理解和编写Cron表达式,以便在系统中实现定时任务的自动化执行。

相关推荐
码观天工1 天前
C#高性能开发之类型系统:从C# 7.0 到C# 14的类型系统演进全景
性能优化·c#·.net·memory·高性能·record·c#14·类型系统
程序员秘密基地1 天前
基于c#,wpf,ef框架,sql server数据库,音乐播放器
sql·sqlserver·c#·.net·wpf
Zhen (Evan) Wang1 天前
.NET 6 WPF 利用CefSharp.Wpf.NETCore显示PDF文件
.net·wpf·.netcore
我是唐青枫2 天前
C# 如何比较两个List是否相等?
c#·.net
时光追逐者2 天前
C#/.NET/.NET Core拾遗补漏合集(25年4月更新)
c#·.net·.netcore
Hellc0072 天前
完整的 .NET 6 分布式定时任务实现(Hangfire + Redis 分布式锁)
redis·分布式·.net
CF14年老兵2 天前
MVC 应用程序中使用 FluentValidation 进行验证的重要性
性能优化·mvc·.net
搬砖工程师Cola2 天前
<C#>.NET WebAPI 的 FromBody ,FromForm ,FromServices等详细解释
开发语言·c#·.net
时光追逐者3 天前
C#/.NET/.NET Core技术前沿周刊 | 第 35 期(2025年4.14-4.20)
c#·.net·.netcore
码观天工3 天前
.NET 原生驾驭 AI 新基建实战系列(四):Qdrant ── 实时高效的向量搜索利器
c#·.net·向量数据库·qdrant