Cron 表达式解析

Cron 表达式最难的地方不是语法,而是几个反直觉的规则 —— 尤其是「日」与「周」同时指定时是「或」而不是「且」,以及星期日既可以是 0 也可以是 7。本工具把字段取值逐个展开,并把接下来 5 次执行时间算出来,让这些规则的影响直接看得见,而不用等到线上任务没按预期跑才发现。

1. 1

   输入表达式

   直接输入或从预设里挑一个。字段数量不对会明确提示应该是 5 个还是 6 个。

2. 2

   检查字段展开

   对照每个字段展开后的取值确认是否符合预期,尤其是带步长或范围的写法。

3. 3

   核对执行时间

   看接下来 5 次执行时间 —— 这是最直观的验证方式。跨月、跨年的边界情况在这里会暴露出来。

4. 4

   确认时区

   服务器常用 UTC,而你可能在北京时间思考。切换时区后再核对一遍,能避免「差 8 小时」这类经典问题。

字段顺序

标准格式为「分 时 日 月 周」5 个字段;带秒格式为「秒 分 时 日 月 周」6 个字段。本工具按字段数量自动识别。

星号 *

表示该字段不限制,取全部可能值。如在「分」字段表示每分钟。

范围 a-b

表示从 a 到 b 的闭区间。如「时」字段写 9-18 表示 9 点到 18 点每小时都执行。

步长 /n

配合 * 或范围使用,表示每隔 n 个单位。如「分」字段写 */15 表示第 0、15、30、45 分执行。

列表 a,b,c

用逗号列出多个值,也可与范围混用,如 0,10-12 表示第 0、10、11、12 分钟。

日与周的或语义

两个字段都不为 * 时,只要满足其中任意一个就会执行。如「0 0 13 * 5」表示每月 13 号**或**每周五执行,而不是两者都满足。这是 Cron 规范中的规定行为。

星期日

0 和 7 都表示周日,二者等价。本工具会把 7 归一为 0,因此两种写法算出的结果完全一致。

月份与星期缩写

月份支持 jan、feb 等三字母缩写(大小写不敏感);标准 Cron 中星期也支持 sun、mon 等,但不同实现的兼容性差异较大,建议直接用数字。

• 配置定时任务前先验证表达式是否符合预期
• 排查「为什么任务没有按预期时间执行」
• 确认带步长的表达式究竟会命中哪些时刻
• 核对服务器 UTC 与本地时间的时区差异
• 把从别人代码里复制来的表达式翻译成人话
• 检查月末、年末这类边界日期是否正确触发
• 了解「日」与「周」同时指定时的实际行为