1. 概述
1.1 应用场景
当设置定时任务调度配置时，如果定时更新频率比较复杂，无法通过「简单重复执行」或「明细频率设置」直接设置时，我们可以通过 Cron 表达式实现。
本文将以示例介绍如何设置 Cron 表达式。
1.2 功能介绍
Cron 表达式为一个字符串，由 5 个或 6 个空格隔开，分为 6 或 7 个域，每一个域代表一个时间范围。Cron有如下两种语法格式：
Seconds Minutes Hours DayofMonth Month DayofWeek Year。
Seconds Minutes Hours DayofMonth Month DayofWeek。
从左到右（用空格隔开）：秒 分 小时 月份中的日期 月份 星期中的日期 年份(可选）。
注：用户可参考 Cron 表达式在线生成工具 检查写的表达式是否正确，确保正确以后填入。
2. Cron表达式规则
每一个域可出现的字符如下：
| 域 | 允许值 | 允许的特殊字符 |
|---|---|---|
| 秒（Seconds） | 0~59的整数 | , - * / 四个字符 |
| 分（Minutes） | 0-59的整数 | , - * / 四个字符 |
| 小时（Hours） | 0-23的整数 | , - * / 四个字符 |
| 日期（DayofMonth） | 0-31的整数（但是需要考虑月的天数） | ,- * ? / L W C 八个字符 |
| 月份（Month） | 1-12的整数或英文JAN-DEC | , - * / 四个字符 |
| 星期（DayofWeek） | 1-7的整数或英文SUN-SAT（1=SUN, 2=MON,...） | , - * ? / L C # 八个字符 |
| 年份（Year） | 1970-2099 | , - * / 四个字符 |
每一个域除了使用数字还可以出现特殊字符，其中特殊字符的含义如下：
| 字符 | 含义 |
|---|---|
| * | 表示匹配该域的任意值，假如在 Minutes 域使用 *，即表示每分钟都会触发事件 |
| ? | 只能用在 DayofMonth（日期）和 DayofWeek（星期）两个域。它也匹配域的任意值，但实际不会。因为 DayofMonth 和 DayofWeek 会相互影响。例如想在每月的 20 日触发调度，不管 20 日到底是星期几，则只能使用如下写法： 13 13 15 20 * ?，其中最后一位只能用 ？，而不能使用 *，如果使用 * 表示不管星期几都会触发，实际上并不是这样 |
| - | 表示范围，例如在 Minutes 域使用 5-20，表示从 5 分到 20 分钟每分钟触发一次 |
| / | 表示起始时间开始触发，然后每隔固定时间触发一次，例如在Minutes域使用 5/20，则意味着 5 分钟触发一次，而 25，45等分别触发一次 |
| , | 表示列出枚举值。例如：在Minutes域使用 5,20，则意味着在 5 和 20 分每分钟触发一次 |
| L | 该字符只在 DayofMonth（日期）和 DayofWeek（星期）域中使用，代表“Last”的意思，但它在两个字段中意思不同。L在日期字段中，表示这个月份的最后一天，如一月的 31 号，非闰年二月的 28 号；如果L用在星期中，则表示星期六，等同于7。但是，如果 L 在前面有一个数值 X ，它就具有其他含义了。例如，月份中的 6L 表示该月的倒数第六天；星期域中的 FRIL 表示这个月的最后一个星期五 |
| W | 该字符只能出现在 DayofMonth（日期）域里，是对前导日期的修饰，表示离该日期最近的工作日（周一到周五）。例如 15W 表示离该月15 号最近的工作日（周一到周五），如果该月15 号是星期六，则匹配 14 号星期五；如果15 日是星期日，则匹配 16 号星期一；如果 15 号是星期二，那结果就是15 号星期二。但必须注意关联的匹配日期不能够跨月，如你指定 1W，如果 1 号是星期六，结果匹配的是 3 号星期一，而非上个月最后的那天。W 字符串只能指定单一日期，而不能指定日期范围 |
| LW | 在 DayofMonth 字段可以组合使用 LW，它的意思是当月的最后一个工作日（周一到周五）。 |
| C | 该字符只在 DayofMonth（日期）和 DayofWeek（星期）域中使用，代表“Calendar”的意思。它的意思是计划所关联的日期，如果日期没有被关联，则相当于日历中所有日期。例如：5C 在日期字段中就相当于日历 5 日以后的第一天；1C 在星期字段中相当于星期日后的第一天 |
| # | 该字符只能在 DayofWeek（星期）域中使用，表示当月某个工作日（周一到周五）。如 6#3 表示当月的第三个星期五( 6 表示星期五，#3表示当前的第三个)；而 4#5 表示当月的第五个星期三，假设当月没有第五个星期三，忽略不触发 |
3. 示例
例如：我们想要实现某个定时任务，每周一到周五早上 8 点更新。
1）对定时任务设置定时更新，如下图所示：
2）在调度配置的编辑界面中，设置执行频率为「表达式设定」，输入对应的 Cron 表达式。
该表达式表示，每周一到周五，上午八点都执行一次更新。
3）点击确定后，即设置成功。
这里我们可以拓展一下：
| 表达式 | 含义 |
|---|---|
| 0 0 8 ? * 2-6 | 每周一到周五，上午 8 点执行一次 |
| 0 0/5 8-9 ? * 2-6 | 每周一到周五的上午 8 点到 9 点期间，每隔 5 分钟执行一次 |
| 0 0 8,17 ? * 2-6 | 每周一到周五的 8 点和 17 点，执行一次 |
3.1 更多示例参考
| 常见场景 | |
|---|---|
| 0 0 8,13 * * ? | 每天的早8、下午1点触发一次 |
| 0 0 8-18 ? * MON-FRI | 每周一到周五的 8-18 点（即一般的工作时间），每整点触发一次 |
| 0 0 12 ? * 2#1 | 每月第一个星期一中午12点触发一次 |
| 0 * 14 * * ? | 每天从下午 2 点开始到 2 点 59 分每分钟一次触发 |
| 0 0/5 14 * * ? | 每天从下午 2 点开始到 2 点 55 分结束每 5 分钟一次触发 |
| 0 55/10 14,18 * * ? | 每天的下午 2 点 55 和 6 点 55 分触发 |
| 0 10,44 14 ? 3 WED | 三月的每周三的14:10和14:44触发 |
| 0 15 10 ? * MON-FRI | 每个周一、周二、周三、周四、周五的10:15触发 |
| 0 15 10 15 * ? | 每月 15 号的 10:15 触发 |
| 0 15 10 L * ? | 每月的最后一天的 10:15 触发 |
| 0 15 10 ? * 6L | 每月最后一个周五的 10:15 触发 |
| 0 15 10 ? * 6L 2002-2005 | 2002 年至 2005 年的每月最后一个周五的 10:15触发 |
| 0 15 10 ? * 6#3 | 每月的第三个周五的 10:15 触发 |
| 0 0 0 L-2 * ? * | 每月倒数第二天（支持 FineReport 10.0，不支持 FineReport 9.0） |
| 简单场景 | |
| */5 * * * * ? | 每隔 5 秒执行一次 |
| 0 */1 * * * ? | 每隔 1 分钟执行一次 |
| 0 0 */1 * * ? | 每隔 1 小时执行一次 |
| 0 0 12 * * ? | 每天 12 点执行一次 |
| 0 0 0,13,18,21 * * ? | 每天的 0 点、13 点、18 点、21 点都触发一次 |
| 0 0 0-8 * * ? | 每天的 0-8点，每整点触发一次 |
| 0 15 10 ? * * | 每天早上 10:15 触发 |
| 0 15 10 * * ? | 每天早上 10:15 触发 |
| 0 15 10 * * ? * | 每天早上 10:15 触发 |
| 0 15 10 * * ? 2024 | 2024 年的 每天早上 10:15 触发 |
