Cron表达式完全指南
定时任务写错一个星号,备份就会在错误的小时跑。先认五段字段,再处理时区,不要把 Quartz 的七段和 Linux crontab 混用。
什么是Cron表达式?
Cron 表达式用五个字段描述「在哪些分钟、小时、日、月、星期运行」(Linux crontab 常见形态)。从左到右:分钟、小时、日、月、星期。取值可以是数字、*(每)、逗号列表、连字符范围、以及 */n 步进。
0 0 * * * 表示每天 0 分 0 时,也就是按机器本地时钟的午夜。表达式里没有时区字段。容器若是 UTC,你在北京以为的凌晨备份,可能在下午才跑。时区要配在 crontab、K8s CronJob 的 TZ、或主机设置里。
还有六段、七段写法(秒、年),常见于 Quartz、部分 Java 调度库。和 Linux 五段不能互换。本站 Cron生成器 面向五段 crontab:生成或把已有一行译成人话。
为什么需要Cron?
备份、拉报表、清缓存、续证书,都是「到点做一次」而不是一直占着进程。用 Cron(或兼容的调度器)比手写 sleep 循环少踩夏令时和进程挂掉的坑,但仍要自己保证任务幂等和锁。
读别人的 crontab 往往比写更难:*/5 9-18 * * 1-5 是工作日白天每五分钟,还是含 18:00?字段边界要对照。生成器的「解释」就是为了减少这种口头误差。
它不管任务成功没有,也不管夏令时那天会不会跑两次。那些是脚本和平台的责任。时间数字对不清时,先用 时间戳转换 看当前 epoch。
如何编写Cron表达式?
每天一次:0 3 * * * 是 03:00。每周一 9:30:30 9 * * 1(星期字段 0 或 7 常表示周日,以你的 cron 实现为准)。每月 1 号:0 0 1 * *。
步进:*/15 * * * * 每 15 分钟。范围:0 9-17 * * * 每小时的 9 到 17 点的 0 分。列表:0 0,12 * * * 午夜和正午。日和星期同时指定时,部分实现对「或 / 且」解释不同,应读所用 cron 的文档,不要假设。
在生成器里用控件拼字段,或把现有一行贴进去看说明。改完再放到 crontab 前,用 crontab -l 和平台 UI 各确认一次 TZ。K8s 的 schedule 同样是五段,时区用 timeZone 字段(视版本而定),不是写在表达式里。
时区、特殊字符和不要做的事
@daily、@hourly 是部分 crontab 的别名,等价于固定五段,但不是所有系统都支持。写进 Alpine 或忙箱前先确认。L、W、? 多见于 Quartz,塞进 vixie cron 会报错。
夏令时:春拨快一小时可能跳过某次运行,秋拨慢可能跑两次。关键任务应按 UTC 写,或在任务内再判断本地日期,而不是指望表达式理解 DST。
不要用 Cron 做精确到毫秒的调度,也不要在表达式里写 Unix 时间戳——那是另一套工具。开发运维向的 HTTP/curl 入口在 开发运维工具大全,时间相关在 时间工具大全。
相关工具
常见问题
0 0 * * * 是什么意思?
每天 0 点 0 分,按运行 Cron 的那台机器(或 CronJob)的时区。
为什么任务晚了八小时?
多半是容器 TZ=UTC,而你按北京时间写了小时字段。改 TZ 或按 UTC 改小时,不要两头都改。
五段和六段有什么区别?
五段无秒;六段常带秒;七段再加年。Linux crontab 默认五段。从 Java 文档复制前先看实现。
星期几从 0 开始还是 1?
常见是 0 或 7 为周日、1 为周一,但实现有差异。以 man 5 crontab 或平台说明为准。
Cron 能保证只运行一次吗?
不能。进程重叠、夏令时、手动补跑都会打破「一次」。任务必须可重入或加锁。