【转】cron表达式详解

leo_qiu_s

已于 2025-04-21 16:06:25 修改

阅读量1.6k

点赞数 8

文章标签：运维

于 2025-03-12 10:59:22 首次发布

本文链接：https://blog.youkuaiyun.com/qiudechao1/article/details/146199397

版权

Cron表达式是一个字符串，字符串以5或6个空格隔开，分为6或7个域，每一个域代表一个含义，Cron有如下两种语法格式：

　　（1） Seconds Minutes Hours DayofMonth Month DayofWeek Year

　　（2）Seconds Minutes Hours DayofMonth Month DayofWeek

　　一、结构

　　corn从左到右（用空格隔开）：秒分小时月份中的日期月份星期中的日期年份

　　二、各字段的含义


字段	允许值	允许的特殊字符
秒（Seconds）	0~59的整数	, - * / 四个字符
分（Minutes）	0~59的整数	, - * / 四个字符
小时（Hours）	0~23的整数	, - * / 四个字符
日期（DayofMonth）	1~31的整数（但是你需要考虑你月的天数）	,- * ? / L W C 八个字符
月份（Month）	1~12的整数或者 JAN-DEC	, - * / 四个字符
星期（DayofWeek）	1~7的整数或者 SUN-SAT （1=SUN）	, - * ? / L C # 八个字符
年(可选，留空)（Year）	1970~2099	, - * / 四个字符

　　注意事项：

　　每一个域都使用数字，但还可以出现如下特殊字符，它们的含义是：

　　（1）*：表示该域的所有值。假如在Minutes域使用*，即表示每分钟都会触发事件。

　　（2）?：表示不指定值，只能用在DayofMonth和DayofWeek两个域中。

DayofMonth和DayofWeek会相互影响，例如每月的20日触发调度：0 0 0 20 * ?，其中最后一位只能用？，而不能用*，如果使用*表示周一到周日每天触发。

0 0 0 20 * ?：表示每月的20日触发；

0 0 0 20 * *：表示每天触发。

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

　　（4）/：表示增量，起始时间/间隔时间。在Minutes域使用0/00，从0分钟开始每隔20分钟触发一次。

　　（5）,：表示枚举值。在Minutes域使用5,20，表示在5分钟和20分钟分别触发一次。

　　（6）L：表示最后一天，只能用在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L，表示每月的最后一个星期四触发（国外周日是每周第一天）。

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

　　（8）LW：这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。

　　（9）#：表示每月的第几个周几，只能用在DayofMonth域。例如在4#2，表示每月的第2个周三。

　　三、常用表达式例子

　　（1）0 0 2 1 * ? * 表示在每月的1日的凌晨2点触发调度。

　　（2）0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15。

　　（3）0 15 10 ? 6L 2002-2006 表示2002-2006年的每个月的最后一个星期五上午10:15。

　　（4）0 0 10,14,16 * * ? 每天10点，14点，16点。

　　（5）0 0/30 9-17 * * ? 9-17点，每半小时。

　　（6）0 0 12 ? * WED 每个星期三12点。

　　（7）0 0 12 * * ? 每天中午12点触发。

　　（8）0 15 10 ? * * 每天上午10:15触发。

　　（9）0 15 10 * * ? 每天上午10:15触发。

　　（10）0 15 10 * * ? * 每天上午10:15触发。

　　（11）0 15 10 * * ? 2005 2005年的每天上午10:15触发。

　　（12）0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发

　　（13）0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发

　　（14）0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发

　　（15）0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发

　　（16）0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发

　　（17）0 15 10 ? * MON-FRI 周一至周五的上午10:15触发

　　（18）0 15 10 15 * ? 每月15日上午10:15触发

　　（19）0 15 10 L * ? 每月最后一日的上午10:15触发

　　（20）0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发

　　（21）0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发

　　（22）0 15 10 ? * 6#3 每月的第三个星期五上午10:15触发

　　注：

　　（1）有些子表达式能包含一些范围或列表

　　例如：子表达式（天（星期））可以为 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”

“*”字符代表所有可能的值。

　　因此，“*”在子表达式（月）里表示每个月的含义，“*”在子表达式（天（星期））表示星期的每一天。

　　“/”字符用来指定数值的增量
　　例如：在子表达式（分钟）里的“0/15”表示从第0分钟开始，每15分钟
在子表达式（分钟）里的“3/20”表示从第3分钟开始，每20分钟（它和“3，23，43”）的含义一样

　　“？”字符仅被用于天（月）和天（星期）两个子表达式，表示不指定值
　　当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“？”

　　“L” 字符仅被用于天（月）和天（星期）两个子表达式，它是单词“last”的缩写
　　但是它在两个子表达式里的含义是不同的。
　　在天（月）子表达式中，“L”表示一个月的最后一天
　　在天（星期）自表达式中，“L”表示一个星期的最后一天，也就是SAT

　　如果在“L”前有具体的内容，它就具有其他的含义了

　　例如：“6L”表示这个月的倒数第６天，“FRIL”表示这个月的最一个星期五
　　注意：在使用“L”参数时，不要指定列表或范围，因为这会导致问题

C#中使用cron表达式的方法和示例

在 C# 中，可以使用 Quartz.NET 这个开源的定时任务库来实现 cron 表达式的调度。使用 Quartz.NET 需要引入对应的 NuGet 包，在项目中添加 using Quartz namespace 后即可使用。

以下是一个简单的示例代码，其中配置文件用到了 Quartz 自带的 CronScheduleBuilder 类：

using Quartz;

using Quartz.Impl;

class Program

{

static void Main(string[] args)

{

// 创建调度器工厂

ISchedulerFactory schedulerFactory = new StdSchedulerFactory();

// 获取调度器

IScheduler scheduler = schedulerFactory.GetScheduler().Result;

// 创建作业

IJobDetail job = JobBuilder.Create<MyJob>()

.WithIdentity("job1", "group1")

.Build();

// 创建触发器

ITrigger trigger = TriggerBuilder.Create()

.WithIdentity("trigger1", "group1")

.WithCronSchedule("0/5 * * * * ?") // 每 5 秒执行一次

.Build();

// 将作业和触发器注册到调度器中

scheduler.ScheduleJob(job, trigger).Wait();

// 开始调度器（定时任务）

scheduler.Start().Wait();

Console.ReadKey();

}

}

public class MyJob : IJob

{

public Task Execute(IJobExecutionContext context)

{

Console.WriteLine("Hello, World!");

return Task.CompletedTask;

}

}

扩展

CronScheduleBuilder 类与示例

CronScheduleBuilder 是 Quartz.NET 中用于构建 CronTrigger 的一个类。它提供了一些方便的方法来构建和解析 cron 表达式，用于定义任务触发的时间和频率；

WithMisfireHandlingInstructionDoNothing：设置当任务错过触发时间时的处理方式，此处的 DoNothing 相当于什么也不做。
WithIdentity：为触发器设置标识符。
WithCronSchedule：设置 cron 表达式，可传入字符串或 CronExpression 对象。
WithSecond：指定触发时间的秒数。
WithMinute：指定触发时间的分钟数。
WithHour：指定触发时间的小时数。
WithDayOfMonth：指定触发时间的日子（月份天数）。
WithMonth：指定触发时间的月份。
WithDayOfWeek：指定触发时间是星期几。

示例：

// 创建 CronScheduleBuilder 对象

var schedule = CronScheduleBuilder.CronSchedule("0/5 * * ? * * *")

// 设置名称和分组

var triggerKey = new TriggerKey("myTrigger", "myGroup")

// 创建 Trigger 对象

var trigger = TriggerBuilder.Create()

.WithIdentity(triggerKey) // 标识符

.WithSchedule(schedule) // 设置调度规则

.StartNow() // 当前时间开始触发

.Build();

CronTrigger 说明

CronTrigger 是 Quartz.NET 中的一个触发器类型，它基于 cron 表达式来定义任务的执行时间和频率。cron 表达式是一种用于指定时间窗口的字符串格式，可以准确地描述任务应该在哪些时间点运行。

CronTrigger 应用广泛，在各种定时任务和自动化脚本中都有应用。它可以实现任务的高精度、多条件调度，提升了任务的可控性和稳定性。

Quartz.NET 说明

Quartz.NET 是一个开源的作业调度框架，可以用于在 .NET 应用程序中实现作业调度功能。

Quartz.NET 是一个用于定时任务的开源框架，它基于 Java Quartz 框架移植而来，提供了多种强大的任务调度方式。Quartz.NET 可以在 .NET 平台上使用，并且与 ASP.NET 和非 Web 应用程序兼容。

Quartz.NET 能够处理数千个作业的执行，可以轻松设置多个触发器和调度规则，还可以与 ADO.NET 数据库进行集成，实现数据持久化和高可用性方案等功能。另外，Quartz.NET 还支持加载和远程调用分布式任务。

Quartz.NET 的工作流程是：首先创建一个调度器（Scheduler），然后创建一个或多个作业（Job），通过触发器（Trigger）在指定时间调度这些作业。每个作业都要实现 IJob 接口，定义 Execute 方法来完成特定的任务。

Quartz.NET 架构是模块化的，在项目中可以选择需要的组件和类库，灵活性很高。常见的组件包括作业调度器（Scheduler）、作业（Job）、触发器（Trigger）和日历（Calendar）等。

ADO.NET 说明

ADO.NET 是一种用于访问数据的技术，它提供了一组用于访问各种数据源的类和接口。

ADO.NET 是一个数据访问技术，为 .NET 应用程序提供了一种可扩展、高效的访问各种数据源的方式。ADO.NET 提供了一组类和接口，使 .NET 开发人员能够轻松地与关系数据库、XML 文档以及其他数据源交互。

使用 ADO.NET，开发人员可以通过多种方式连接到数据源，如 SQL Server 数据库、Oracle 数据库、Microsoft Access 数据库等其他数据源，也可以使用 OLE DB 和 ODBC 连接任何兼容的数据源。数据源连接之后，就可以使用 DataReader 和 DataSet 对象获取数据，并进行操作，添加、修改、删除等。

ADO.NET 采用面向对象的编程思想，开发人员只需编写少量的代码即可从数据源中检索数据、操作数据。此外，ADO.NET 还可以在本地缓存数据，以提高查询效率和灵活性。

ADO.NET 是微软发布的新一代数据库访问技术，旨在将多种数据源纳入到 .NET 框架之下，是 .NET 环境下的首选数据库访问技术。