1. 基础:
1.1. 介绍
Cron 表达式是一个字符串,分为 6 或 7 个域,每两个域之间用空格分隔。(6 个域的时候是省略了年域)
格式:
"秒域 分域 时域 日域 月域 周域 年域"
其中,年域可以省略,省略时表示每年。
单个域取多个值的时候,用“,”(英文逗号)隔开。
每个域可以实确定的取值,也可以是具有逻辑意义的特殊字符。
每个域最多支持一个前导零。
1.2. 字段解释
字段 | 范围值 | 允许的特殊字符(| 为分隔字符) |
秒(Seconds) | 0~59 的整数 | ,|-|*|/ 四个字符 |
分(Minutes) | 0~59 的整数 | ,|-|*|/ 四个字符 |
时(Hours) | 0~23 的整数 | ,|-|*|/ 四个字符 |
日(DayofMonth) | 1~31 的整数(需要考虑实际天数) | ,|-|*|?|/|L|W|C 八个字符 |
月(Month) | 1~12 的整数或者 JAN-DEC | ,|-|*|/ 四个字符 |
周(DayofWeek) | 1~7 的整数或者 SUM-SAT | ,|-|*|?|/|L|C|# 八个字符 |
年(Year) | 1970~2009 | ,|-|*|/ 四个字符 |
1.3. 字符的含义:
特殊字符 | 含义 | 适用域 | 实例 |
* | 表示可以匹配该域的所有值 | 全域 | 在月域中,* 表示每个月;在星期域中,*表示星期的每一天。 |
? | 不指定值,仅日期与星期域支持该字符。必须出现且仅能出现 1 次 | 日域/周域 | 当日期或星期域其中之一被指定了值以后,为了避免冲突,需要将另一个域的值设为?。 |
- | 指定一个范围。 | 全域 | 在 分域 中使用 10-12,则代表,10 分钟,11 分钟,12 分钟 执行。 |
, | 列出指定的值 | 全域 | 在 分域 使用 10,20,则表示 10 分钟和 20 分钟的时候各自触发一次事件。 |
/ | 指步长。/ 前面是起始时间,/ 后面是结束时间。 | 全域 | 在 分域 中使用 10/15,则表示在 10 分钟,25 分钟,40 分钟,55 分钟 触发执行。 符号“*”在“/”前面(如:*/10)等价于 0 在“/”前面(如:0/10) |
L | 单词 Last 的首字母。表示最后一天,仅日期与星期域支持该字符。 说明:指定 L 字符时,避免指定列表或范围,否则,会导致逻辑问题。 | 日期域/星期域 | 在日期域中,L 表示某月的最后一天。在星期域中,L 表示一个星期的最后一天,也就是星期日(SUM)。 如果在 L 前有具体的内容,例如,在星期域中的 6L 表示这个月的最后一个星期 5。 |
W | 表示有效工作日,只能出现在日期域。 这个字符用于距离指定日期的最近工作日触发事件。“W”字符指定的最近工作日是不能够跨月份的,字符“W”只能配合一个单独的数值使用,不能够是一个数字段,如:1-15W 是错误的。 | 日期域 | 在日期域中 5W,如果 5 日是星期六,则将在最近的工作日星期五,即 4 日触发。如果 5 日是星期天,则将在最近的工作日星期一,即 6 日触发;如果 5 日在星期一到星期五中的一天,则就在 5 日触发。 |
LW | L 和 W 可以在日期域中联合使用。LW 表示这个月最后一周的工作日。 | 日期域 | |
# | 确定每个月第几个星期几,仅星期域支持该字符。 | 星期域 | 例如在 4#2,表示某月的第二个星期三。即 X#Y,表示某月的第 Y 个星期(X-1)(因为 1 代表的时星期日) |
C | 这个字符依靠一个指定的“日历”。也就是说这个表单式的值依赖于相关的“日历”的计算结果,如果没有“日历”关联,则等价于所有包含的“日历”. | 月域/周域 | 日期域是“5C”表示关联“日历”中第一天,或者这个月开始的第一天的后 5 天。星期域是“1C”表示关联“日历”中第一天。或者星期的第一天的后一天,也就是周日的后一天(周一) |
1.4. 常用的表达式:
表达式 | 解释 | 执行的时间 |
* * * * ? * * 或者 * * * ? * * * | 每秒执行一次 | 2024-01-10 11:37:47 2024-01-10 11:37:48 2024-01-10 11:37:49 |
0 * * * * ? * 或者 0 * * ? * * | 每分钟执行一次 / 在每分钟的第 0 秒执行 | 2024-01-10 11:38:00 2024-01-10 11:39:00 2024-01-10 11:40:00 |
0 0/16 * * * ? * | 每 16 分钟执行一次 / 从每小时的第 0 分钟开始,每隔 16 分钟执行一次。 仅在一个小时内间隔 16 分钟,到下一个小时继续从 0 分钟开始执行 | 2024-01-18 16:00:00 2024-01-18 16:16:00 2024-01-18 16:32:00 2024-01-18 16:48:00 2024-01-18 17:00:00 |
0 0 * ? * * * 或者 0 0 * * * ?* | 每小时执行一次 / 在每小时的 0 分 0 秒执行 | 2024-01-10 11:00:00 2024-01-10 12:00:00 2024-01-10 13:00:00 |
0 0 0 * * ? * | 每天执行一次 / 在每天的 0 时 0 分 0 秒执行 | 2024-01-10 00:00:00 2024-01-11 00:00:00 2024-01-12 00:00:00 |
0 0 0 1 * ? * | 每月的 1 号执行一次 / 每月 1 号的 0 时 0 分 0 秒执行 | 2024-01-01 00:00:00 2024-02-01 00:00:00 2024-03-01 00:00:00 |
0 0 0 31 * ? * | 每月的 31 号执行一次。 这里只会在 1,3,5,7,8,10,12 月份执行(仅是在线工具中测试得出的结论) | 2024-01-31 00:00:00 2024-03-31 00:00:00 2024-05-31 00:00:00 |
0 0 0 L * ? * | 每个月的最后一天执行 | 2024-01-31 00:00:00 2024-02-29 00:00:00 2024-03-31 00:00:00 2024-04-30 00:00:00 2024-05-31 00:00:00 |
0 0 0 ? * 4 * | 每周三运行 / 每周三的 0 时 0 分 0 秒执行 | 2024-01-24 00:00:00 2024-01-31 00:00:00 2024-02-07 00:00:00 |
0 30 8 ? * 2-6 | 周一到周五,每天八点半提醒 | 2024-01-19 08:30:00 2024-01-22 08:30:00 2024-01-23 08:30:00 2024-01-24 08:30:00 |
0 0 0 ? * 4#2 * | 每月的第二个星期四执行。 (作者认为,每月开始的第一周大于 3 天,便算是第一周,如果小于等于 3 天便不算是一周) | 2024-02-08 00:00:00 2024-03-14 00:00:00 2024-04-11 00:00:00 2024-05-09 00:00:00 |
周一到周五,每天 8:30 提醒一次,18 时提醒一次 | 这样的只能写两个定时任务 |
2. 参考
参考文章:
https://www.cnblogs.com/hungryquiter/p/16972952.html
常用的 cron 表达式在线工具:
https://cron.qqe2.com/?spm=a2c6h.12873639.article-detail.7.3301679dUAtuLX
https://www.bejson.com/othertools/cronvalidate/
作者水平有限,文中难免会有错误,请发现错误的朋友在评论区留言,作者会及时改正,避免误导他人。