Quartz.NET 定时任务框架中的 CronTrigger 完全指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00781/article/details/148465558

Quartz.NET 定时任务框架中的 CronTrigger 完全指南

quartznet Quartz Enterprise Scheduler .NET 项目地址: https://gitcode.com/gh_mirrors/qu/quartznet

前言

在任务调度领域，CronTrigger 是最强大且最常用的触发器类型之一。作为 Quartz.NET 框架的核心组件，它基于经典的 Unix cron 表达式语法，提供了极其灵活的任务调度能力。本文将深入解析 CronTrigger 的使用方法，帮助开发者掌握这一强大的调度工具。

CronTrigger 基础概念

CronTrigger 允许开发者使用 cron 表达式来定义复杂的调度计划，例如：

每周一至周五上午8点执行
每月最后一个周五凌晨1:30执行
每年特定月份的特定日期执行

这种基于表达式的调度方式既强大又灵活，但同时也带来了学习曲线。理解 cron 表达式的结构和特殊字符是掌握 CronTrigger 的关键。

Cron 表达式结构详解

一个标准的 cron 表达式由6或7个字段组成，字段间用空格分隔。各字段的含义如下：

| 字段名 | 必填 | 允许值 | 允许的特殊字符 | |----------------|----------|-------------------|--------------------------| | 秒(Seconds) | 是 | 0-59 | , - * / | | 分(Minutes) | 是 | 0-59 | , - * / | | 时(Hours) | 是 | 0-23 | , - * / | | 日(Day of month)| 是 | 1-31 | , - * ? / L W | | 月(Month) | 是 | 1-12或JAN-DEC | , - * / | | 周(Day of week)| 是 | 1-7或SUN-SAT | , - * ? / L # | | 年(Year) | 否 | 空或1970-2099 | , - * / |

特殊字符全解析

星号(*)：表示匹配该字段的所有可能值。例如在分钟字段使用*表示"每分钟"。
问号(?)：用于在不关心的字段上占位。通常在日和周期字段中互斥使用。
连字符(-)：定义范围。例如10-12在小时字段表示"10点、11点和12点"。
逗号(,)：指定多个值。例如MON,WED,FRI表示"周一、周三和周五"。
斜杠(/)：定义增量。例如：
- 0/15在秒字段表示"0秒、15秒、30秒和45秒"
- 5/15表示"5秒、20秒、35秒和50秒"
- 1/3在日字段表示"从每月1日开始，每3天触发一次"
L(Last)：特殊含义字符：
- 在日字段单独使用表示"当月最后一天"
- 在周字段单独使用等同于"7"或"SAT"
- 组合使用如6L表示"当月最后一个周五"
W(Weekday)：指定最近的工作日。例如：
- 15W表示"最接近15号的工作日"
- 1W表示"最接近1号的工作日(不会跨月)"
组合使用LW：表示"当月最后一个工作日"，可带偏移量如LW-2。
井号(#)：指定月份中第几个周几。例如：
- 6#3表示"当月第三个周五"
- 2#1表示"当月第一个周一"

实用示例大全

| 表达式 | 含义 | |------------------------|--------------------------------------------------------------------------| | 0 0 12 * * ? | 每天中午12点触发 | | 0 15 10 ? * MON-FRI | 每周一至周五上午10:15触发 | | 0 15 10 L * ? | 每月最后一天上午10:15触发 | | 0 15 10 ? * 6L | 每月最后一个周五上午10:15触发 | | 0 15 10 ? * 6#3 | 每月第三个周五上午10:15触发 | | 0 0/5 14,18 * * ? | 每天14:00至14:55和18:00至18:55期间，每5分钟触发一次 | | 0 11 11 11 11 ? | 每年11月11日11:11触发(特殊日期提醒) | | 0 15 10 1,15 * ? | 每月1日和15日上午10:15触发 |