怎么用
粘贴 @Scheduled(cron = "...") 里的表达式、点一个示例,或者按选项生成。含义和接下来 10 次执行时间会实时更新。
写法
Spring cron表达式采用 6 个字段,格式为:
秒 分 时 日 月 星期
| 字段 | 可用的值 |
|---|---|
| 秒 | 0–59 |
| 分 | 0–59 |
| 时 | 0–23 |
| 日 | 1–31、?、L、L-n、LW、nW |
| 月 | 1–12 或 JAN–DEC |
| 星期 | 0–7 或 MON–SUN(0 和 7 都是星期日)、?、dL、d#n |
Spring 也支持 @yearly、@monthly、@weekly、@daily、@hourly。
几个例子:
| 表达式 | 执行时间 |
|---|---|
*/30 * * * * * |
每 30 秒 |
0 0 9 * * MON-FRI |
工作日 9:00 |
0 0 0 L * * |
每月最后一天 0:00 |
0 0 9 * * MON#1 |
每月第一个星期一 9:00 |
0 0 18 * * 5L |
每月最后一个星期五 18:00 |
小提示
- Spring 必须写 6 个字段。直接用 5 个字段的 Linux 写法会报错 "Cron expression must consist of 6 fields",在最前面加一个秒字段
0就行。这也是 springboot定时任务cron 和标准 Linux cron 最常见的区别。 - 同时指定“日”和“星期”时,两个都要满足。
0 0 12 1 * MON只在 1 号恰好是星期一时执行;换成 Linux cron,则会在每月 1 号和每个星期一都执行。 - 星期的编号和 cron 一致(0 或 7 = 星期日),和 Quartz(1 = 星期日)不同。如果你需要兼容 Quartz 的写法,可以使用 Quartz Cron 表达式生成器。
- 默认按服务器的时区执行,可以用
@Scheduled的zone属性指定时区。
更多说明
上面表格里的 L、W、# 等特殊符号都是 Spring cron表达式支持的扩展写法,方便你描述“最后一个工作日”“每月第几个星期几”这类需求。如果你在 @scheduled cron表达式 里用到了这些符号,本工具会自动解析并显示对应含义和接下来的执行时间,无需手动换算。
想系统了解各字段含义和常见写法,可以阅读 Cron 表达式详解:完全指南;如果需要标准的 5 字段 Linux cron,可使用 Cron 表达式生成器(在线解析)。