Cron 表达式是一行很短的文本,用来告诉调度器什么时候执行任务。Linux 的 crontab、Kubernetes 的 CronJob、GitHub Actions 以及很多任务库都在用它。这篇 cron表达式详解 先讲标准的 5 字段写法,再讲最容易出错的几个地方,帮助你看懂 cron表达式语法,并掌握常见的 crontab用法。
5 个字段
┌───────────── 分钟(0–59)
│ ┌─────────── 小时(0–23)
│ │ ┌───────── 日(1–31)
│ │ │ ┌─────── 月(1–12 或 JAN–DEC)
│ │ │ │ ┌───── 星期(0–7 或 SUN–SAT,0 和 7 都是星期日)
│ │ │ │ │
* * * * * 要执行的命令
当前时间和所有字段都匹配时,任务就会执行。30 8 * * * 表示 8 点 30 分,日和月都不限,也就是每天 8:30。理解这 5 个字段是掌握 cron表达式语法 的第一步。
特殊字符
| 字符 | 含义 | 示例 |
|---|---|---|
* |
所有值 | * * * * * 每分钟执行 |
, |
列举多个值 | 0 9,18 * * * 在 9:00 和 18:00 执行 |
- |
范围 | 0 9 * * 1-5 工作日 9:00 执行 |
/ |
间隔 | */15 * * * * 每 15 分钟执行 |
间隔也可以和范围一起用:0 9-17/2 * * * 会在 9:00、11:00、13:00、15:00 和 17:00 执行。大多数实现还支持简写:@hourly、@daily、@weekly、@monthly、@yearly,以及 @reboot(开机时执行一次)。这些简写是 crontab用法 里很常见的省力写法。
常用写法
| 表达式 | 执行时间 |
|---|---|
*/5 * * * * |
每 5 分钟 |
0 * * * * |
每小时整点 |
0 */6 * * * |
每 6 小时(0:00、6:00、12:00、18:00) |
0 2 * * * |
每天 2:00 |
30 8 * * 1-5 |
工作日 8:30 |
0 9-17 * * 1-5 |
工作日 9:00 到 17:00 之间每小时一次 |
0 9 * * 1 |
每周一 9:00 |
0 22 * * 0,6 |
周末 22:00 |
0 0 1 * * |
每月 1 号零点 |
0 0 1 1 * |
每年 1 月 1 日零点 |
把任意一条粘贴到 Cron 表达式解析 工具里,就能看到接下来的执行时间。
“日”和“星期”的陷阱
同时限定了“日”和“星期”时,标准 cron 会在满足其中一个的日子执行,而不是两个都满足才执行。0 9 1 * 1 并不是“1 号恰好是星期一时执行”,而是每月 1 号和每个星期一都会执行。这是 cron表达式详解 中最常被忽视的规则之一。
这条规则只在两个字段都不以 * 开头时生效。如果想在每月第一个星期一执行,可以把“日”限定为 1–7,再在命令里判断星期:
0 9 1-7 * * [ "$(date +\%u)" -eq 1 ] && /path/to/job
在 crontab 里,% 有特殊含义(表示标准输入的开始),所以要写成 \%。这类细节在实际 crontab用法 中很容易踩坑。
时区和夏令时
cron 按运行它的机器或服务的时区执行:
- Linux crontab 用系统时区。cronie 等部分实现还支持在文件里写一行
CRON_TZ=。 - Kubernetes CronJob 默认用控制器的时区,可以用
spec.timeZone指定,例如Asia/Shanghai。 - GitHub Actions 的定时任务始终按 UTC 计算,负载高时可能晚几分钟才开始,而且最短只能每 5 分钟执行一次。
在有夏令时的地区,如果任务正好安排在被跳过或重复的那个小时里,可能不执行,也可能执行两次,具体取决于实现。必须每天只执行一次的任务,最好避开当地时间 1:00–3:00,或者让机器使用 UTC。
Spring 和 Quartz
Java 的调度框架用的是带秒字段的变体:
| Linux cron | Spring | Quartz | |
|---|---|---|---|
| 字段数 | 5 | 6(最前面是秒) | 6 或 7(最前面是秒,年可选) |
| 星期日 | 0 或 7 | 0 或 7 | 1 |
L、W、#、? |
不支持 | 支持 | 支持 |
| 同时指定“日”和“星期” | 满足一个即可 | 两个都要满足 | 必须有一个写 ? |
两者的详细规则见 Spring Cron 表达式生成器 和 Quartz Cron 表达式生成器。这部分是对标准 cron表达式语法 的扩展,写法并不完全兼容。
上线前先检查
写错的 cron 表达式通常不会报错,只会在错误的时间执行,或者根本不执行。上线前把它粘贴到 Cron 表达式解析 工具里:工具会用大白话解释它的含义,并按本地时间或 UTC 列出接下来 10 次执行时间。把这篇 cron表达式详解 当作速查,再配合工具验证,能减少大部分定时任务的配置失误。