Cron 表达式生成器

Cron 表达式是什么？

Cron 表达式是描述周期性计划的一种紧凑写法。它和 Unix cron（最早的 Linux 定时调度器）用的是同一套语法，如今几乎所有任务调度工具都在用它：Kubernetes CronJob、GitHub Actions 定时触发、AWS EventBridge、Cloudflare Workers、Vercel cron，以及大多数 CI/CD 平台。

这种格式看起来吓人，其实只是用空格分隔的五个字段：分钟、小时、日期（一个月中的第几天）、月份、星期。每个字段可以是一个数字、一个列表（1,15）、一个范围（9-17）、一个步长（*/5）或通配符（*）。好用的 cron 工具会把表达式翻译成易懂的语言，并列出接下来的触发时间，让你在部署前就能核对。

有些平台在基础的 5 字段语法上做了扩展，在开头加一个“秒”字段（Quartz、Spring、Kubernetes 的 6 字段格式），或在末尾加一个“年”字段。粘贴表达式之前，务必先确认你的调度器接受哪种格式。

编写 cron 计划时你会学到什么

• 标准 cron 表达式有 5 个字段：分钟、小时、日期、月份、星期。
• * 表示该字段的“每一个值”，这也是计划触发次数比预期多的最常见原因。
• */N 表示“每 N 个单位”，分钟字段里的 */5 就是“每 5 分钟”。
• 日期和星期两个字段会相互影响：两者都设置会改变计划的范围，而在经典 Unix cron 中，把其中一个设为 *、只给另一个指定值，才是表达“仅工作日”或“仅每月某天”规则的稳妥写法。

一步步写出 cron 表达式

1. 1

   从预设开始

   选一个和你需求接近的预设，例如“每分钟”“每小时”“每天 09:00”“工作日 09:00”“每月 1 日”。表达式会出现在编辑器里。

2. 2

   调整每个字段

   编辑分钟、小时、日期、月份、星期。用 * 表示任意值，也可以用逗号列表、范围（9-17）或步长（*/15）。

3. 3

   阅读易懂的解释

   工具会把你的表达式翻译成一句话（例如“在 09:00 每逢工作日”）。如果这句话和你想要的不一致，说明表达式写错了。

4. 4

   预览接下来的触发时间

   按你所在的本地时区核对接下来 5 至 10 次的运行时间。如果计划时间靠近夏令时切换点，要特别留意。

5. 5

   复制到你的调度器

   把表达式放进你的 crontab、GitHub Actions 工作流、Kubernetes CronJob，或你正在使用的任何调度器。

Cron 字段速查表

标准 cron 表达式的五个字段，按顺序排列。参考：POSIX crontab(5) 手册页。

可以动手试试的 cron 表达式示例

Cron 的常见错误

• 忘了时区。大多数 cron 守护进程按“服务器”的时区触发，而不是你的时区。平台支持的话，请显式设置时区。
• 同时设置日期和星期。在经典 Unix cron 中，只要某天满足“其中任意一个”条件就会触发，大多数人第一次遇到都会吃惊。
• 用 */45 并以为它每 45 分钟触发一次。步长是从 0 开始计算的，所以 */45 在第 0 分和第 45 分触发，并不是真正的 45 分钟间隔。
• 部署前不预览接下来的触发时间。一个“差不多对”的 cron 表达式，触发频率可能是预期的 60 倍。
• 忘了夏令时切换。0 2 * * * 这样的计划，在时钟回拨那天可能运行两次，而在时钟拨快那天一次也不运行。

Cron 表达式常见问题