这个工具做什么
Cron 表达式是一串用空格分隔的字段,用来描述「什么时候执行一次任务」。它出现在 Linux 的 crontab、各类任务调度服务、应用框架的定时注解、容器编排的定时任务里。表达式本身很短,但字段顺序、取值范围和特殊符号很容易记混,写完之后也很难一眼确认「下一次到底什么时候跑」。这个工具把表达式拆开,逐段翻译成中文,并按本机时区推算出未来 5 次执行时间。
工具接受两种写法:5 段的「分 时 日 月 周」和 6 段的「秒 分 时 日 月 周」。输入后会先数段数,并在输入框下方与结果区明确写出当前按几段解析,避免把 5 段表达式误当成 6 段。支持的语法包括:* 表示任意值,? 在本工具中等同于 *,单个数字、逗号列表(如 1,15,30)、范围(如 9-18)、步长(如 */5 与 0-30/10)。月份可以使用 JAN 到 DEC,星期可以使用 SUN 到 SAT,大小写均可。
所有解析与时间推算都在浏览器本地完成,不联网、不上传,也不会把表达式写进本地存储。刷新页面后输入与结果都会消失。
怎么用
在左侧输入框里填写表达式,然后点「解析」或按回车。输入框下方会实时显示当前识别到的段数:5 段按「分 时 日 月 周」解析,6 段按「秒 分 时 日 月 周」解析。段数不是 5 或 6 时,提示会直接说明当前有几段,并给出两种写法的示例。
如果只是想快速看一个常见周期,可以直接点预设按钮:每分钟、每 5 分钟、每小时、每天 0 点、每周一 9 点、每月 1 号。点击后表达式会填入输入框并立即解析,不需要再点一次「解析」。
右侧结果分为三块:顶部一句话说明按几段解析以及最近一次执行时间;中间逐段列出「第几段、原始写法、中文含义」;底部按本地时区列出未来 5 次执行时间,格式固定为 YYYY-MM-DD HH:mm:ss。秒级表达式会把秒字段一起参与计算,因此 6 段写法可能得到连续几秒的结果。
如果表达式有问题,提示会落在输入框下方的状态区域,不会弹窗。错误信息会指出是第几段、哪一段名称、哪个片段不合法,例如「第 2 段(小时)中的「25」超出范围 0–23」,方便直接定位到要改的位置。
结果怎么解读
先看段数。5 段表达式的最低精度是分钟,字段顺序为分钟、小时、日、月、星期;6 段表达式在分钟前面多了一个秒,最低精度是秒。同一个意图在不同写法下数字会整体后移一位,例如每天 2 点执行,5 段写法是 0 2 * * *,6 段写法是 0 0 2 * * *。把 5 段表达式直接塞进要求 6 段的平台,平台会把第一个数字当成秒,执行时间就完全变了。
| 位置 | 5 段表达式 | 6 段表达式 |
|---|---|---|
| 第 1 段 | 分钟 | 秒 |
| 第 2 段 | 小时 | 分钟 |
| 第 3 段 | 日 | 小时 |
| 第 4 段 | 月 | 日 |
| 第 5 段 | 星期 | 月 |
| 第 6 段 | — | 星期 |
其次是时区。本工具使用浏览器所在的本地时区来推算并格式化执行时间,页面顶部会显示当前时区名称。但表达式真正在服务器上执行时,用的是服务器的时区:Linux crontab 通常跟随系统时区,容器镜像默认多为 UTC,应用框架和编排平台则需要单独设置时区参数。同一句 0 2 * * *,在 UTC 服务器上对应北京时间上午 10 点,而不是凌晨 2 点。跨时区核对时,先确认执行环境的时区,再判断结果是否符合预期。
还要注意「日」与「星期」的组合规则。标准 Vixie cron 规定:当第 3 段(日)和第 5 段(星期)都不是通配符时,两者是「或」的关系,只要其中一个条件满足就会触发。例如 0 0 1 * 1 表示「每月 1 日或每周一」,而不是「既是 1 日又是周一」。很多框架沿用了这一行为,也有部分平台改成「与」。本工具按 Vixie cron 的「或」语义计算,并在结果区给出提示。若只想按日期执行,把星期写成 *;只想按星期执行,把日写成 *,这样语义最清楚,也不会受平台差异影响。
最后是取值范围。星期字段的 0 和 7 都表示周日,本工具会把 7 归一成 0。月份是 1 到 12,日是 1 到 31,小时是 0 到 23。写成超出范围的值(例如 24 点、13 月)会直接报错,而不是被悄悄截断。
常见情况与限制
表达式长度上限是 120 字符。正常的 Cron 表达式远达不到这个长度,设置上限主要是为了避免误粘贴整段配置或日志导致页面卡住。超过上限时不会截断后继续解析,而是直接提示当前长度并中止。
未来执行时间最多向后扫描 5 年,并且只取前 5 次。如果表达式合法但在这 5 年内没有任何触发时间,例如把日期写成 2 月 30 日,工具会明确提示「该表达式在可预见的 5 年内没有触发时间」。扫描过程最多迭代 200 万步,超过上限会中止并提示,避免极端输入长时间占用页面。这里的「步」包括逐日检查和逐个时间点比对。
夏令时会让某些本地钟点不存在或出现两次。本工具按浏览器的本地时间构造每一个候选时刻,遇到夏令时跳变时,个别时间可能被系统自动平移到相邻钟点,或者被去重。生产环境里的定时任务通常应固定使用 UTC 或明确指定时区,不要依赖运行机器的本地时区,否则一年两次的时钟调整就可能让任务提前、推迟或重复执行。
秒级表达式并非所有平台都支持。传统 crontab(Vixie cron、cronie 等)只接受 5 段,没有秒字段;Quartz、Spring 的定时注解以及部分调度服务支持 6 段,但字段含义和可选扩展(例如年字段、L、W、#)并不完全一致。本工具只处理常见的 5 段与 6 段写法,不支持 @daily 这类宏,也不支持「每月最后一个工作日」之类的高级语法。把结果复制到目标平台前,请先确认该平台的字段顺序和扩展支持情况。
? 在本工具中按通配符处理。Quartz 里 ? 只用于「日」或「星期」,表示不指定该字段,通常要求另一段也做相应设置;如果目标平台对 ? 有额外约束,请以平台文档为准。为了避免歧义,日常书写建议直接用 *。