Cron表达式生成器 - 在线生成Linux/Quartz定时任务表达式
🌙 写 cron 的人,最后都绕回同一个问题
凌晨改定时任务,最怕的不是写不出来,是写完不知道对不对。
第一种情况是纯手写。要给备份脚本配一个凌晨两点的计划,脑子里过一遍:0 2 * * *。转头 Java 那边的报表任务也要两点跑,于是又得写一遍 0 0 2 * * ?。两个都对,但字符数不一样,多一个零少一个问号,全靠记忆。写多了会形成一种奇怪的肌肉记忆:数星号,数到五个松口气,数到六个再确认最后一位是不是 ?。
第二种情况更常见——接手别人的表达式。运维交接文档里躺着一行 0 0/10 * * * ?,你想改成每 15 分钟,盯着那个 0/10 犹豫了半天:这个 0 是起点还是秒?直接改成 0/15 行不行?万一理解错了,改完变成每小时跑一次,第二天早上才发现,中间十个小时的数据全是空的。
第三种是两套环境各写一份。后端是 Java,调度走 Quartz;部署脚本在 Linux,任务写在 crontab。同一句「工作日早上九点半」,一边是 30 9 * * 1-5,另一边是 0 30 9 ? * MON-FRI。谁抄谁都会错,因为这两套写法不是「多加一段」的关系。
这三个场景指向同一件事:cron 的难点不在语法,在于你每次都要在脑子里做一次翻译,而且没有地方核对结果。 星点 Cron 表达式生成器 处理的是「翻译 + 核对」这一步:选方言,用预设或表单把计划填进去,实时拿到表达式、校验结果和人话解释;不放心的话,再一键带出到解析页看它未来几次到底什么时候跑。
🧬 生成之前,先决定说哪种方言
这是整个流程里最该先做、也最容易被跳过的一步。同一个「每天两点」,两种方言写出来完全不是一回事。
五字段和六字段
Linux/Unix 的经典 crontab 是五段:
分 时 日 月 星期0 2 * * *Quartz 风格是六段,最前面多一个「秒」,第七段「年」可选:
秒 分 时 日 月 星期 [年]0 0 2 * * ?差别不只是「多一个字段」。摆在一起看更清楚:
| 对比项 | Linux / crontab | Quartz |
|---|---|---|
| 字段数 | 5 | 6,或 7(带年) |
| 最小粒度 | 1 分钟 | 1 秒 |
| 字段顺序 | 分 时 日 月 星期 | 秒 分 时 日 月 星期 |
| 星期的值 | 0–7,0 和 7 都是周日 | 1–7,1 是周日 |
? | 不支持 | 支持,只能用在「日」和「星期」 |
L W # | 不支持 | 支持 |
| 日与星期同时限定 | 允许,语义是「或」 | 不允许,必须有一个写 ? |
同一句需求,两种写法摆一起
下面是日常最常配的几条,左边可以直接贴 crontab,右边可以直接贴 @Scheduled 或 CronTrigger:
| 计划 | Linux 五字段 | Quartz 六字段 |
|---|---|---|
| 每天 02:00 | 0 2 * * * | 0 0 2 * * ? |
| 工作日 09:30 | 30 9 * * 1-5 | 0 30 9 ? * MON-FRI |
| 每周一 09:00 | 0 9 * * 1 | 0 0 9 ? * MON |
| 每月 1 日 00:00 | 0 0 1 * * | 0 0 0 1 * ? |
| 每 5 分钟 | */5 * * * * | 0 */5 * * * ? |
对照着看,会发现两边的差异不是「整体右移一位」那么简单。Quartz 除了在开头补一个秒位,还得在「星期」被限定时把「日」改成 ?。所以 0 2 * * * 对应的不是 0 0 2 * * *,而是 0 0 2 * * ?——后面那个 * 会让表达式直接不合法。抄的时候只想着「前面加个 0」,必错。
正因为这样,生成器把方言做成了一个必须显式选择的开关,而不是自动猜。选错方言,工具不会帮你「兼容」,它只会按你选的那一套校验,把不合适的地方标出来。
一个操作细节先提醒:在生成器里切换方言,表单会被重置成该方言的默认值,高级输入框也会跟着重置。 这不是 bug——把 Linux 的字段值硬塞进 Quartz 的六个位置,只会得到一串看起来合法、含义全错的表达式。如果你手上已经有一段贴好的表达式,先复制出来,再切方言。
🛠 三样东西:预设、表单、高级
页面上真正的输入方式有三种,各管一段。
预设:从一个最接近的计划开始
下拉里有七条:
| 预设 | Linux | Quartz |
|---|---|---|
| 每分钟 | * * * * * | 0 * * * * ? |
| 每 5 分钟 | */5 * * * * | 0 */5 * * * ? |
| 每小时 | 0 * * * * | 0 0 * * * ? |
| 每天 09:00 | 0 9 * * * | 0 0 9 * * ? |
| 工作日 09:00 | 0 9 * * 1-5 | 0 0 9 ? * MON-FRI |
| 每周一 09:00 | 0 9 * * 1 | 0 0 9 ? * MON |
| 每月 1 日 00:00 | 0 0 1 * * | 0 0 0 1 * ? |
预设是起点,不是终点。选中之后表达式会立刻填进表单的各个字段,接着就能改。比如要「每天 02:00」,选「每天 09:00」,把「时」从 9 改成 2,一分钟的事,比从默认的「每分钟」开始逐个字段改稳当。
注意预设里没有「每天 02:00」「工作日 09:30」这种具体时刻。这是有意的:预设只覆盖结构(每分钟、每小时、每天、每周、每月),时刻交给你填。硬把每个时刻都做成预设,下拉会长到没法用。
表单:逐字段填,边填边看
表单就是按方言把字段一格一格排开。Linux 五个输入框:分、时、日、月、星期;Quartz 多出「秒」和「年」。每个框的占位提示里写着允许范围,比如分是 0-59,日是 1-31 / L / ?,星期在 Quartz 下是 1-7 / ? / #。
改任何一个框,下面的「生成的表达式」立刻更新,同时跑一遍校验:
- 合法:显示「表达式合法(Linux 五字段)」,接着给出语义说明和逐字段解释;
- 不合法:用红字报错,并把问题定位到具体字段——字段数不对、某个字段超出取值范围(比如分钟写了 60)、在 Linux 方言下用了
?、Quartz 里日与星期同时指定,都会分别指出来。
有两个行为值得知道:
- 字段留空等于取任意值。 把「分」清空,生成时会当成
*;Quartz 的秒留空会当成0,星期留空会当成?。不会报错,但结果可能不是你想要的,填完扫一眼表达式再走。 - 「年」留空表示不限年份。 填
*也一样会被当成空,不会生成七字段。只有填了具体年份(或多个年份)才会补上第七段。
高级:直接贴,再同步回表单
手上有现成表达式、或者写法超出表单能表达的范围时,切到「高级」,把表达式贴进去。校验、语义说明、带出验证这些能力全都还在,只是不再用字段拼。
高级模式最有用的按钮是「同步到表单」:它按当前方言的字段数把表达式拆回各个输入框,然后切回表单模式。适合这两种情况:
- 别人给了你一行表达式,你想改成别的时刻,但懒得逐字符数位置;
- 你在高级里试了几种写法,最后想固定下来,回到表单里可视化地调。
拆不动会直接报错,提示「无法按 5 字段拆分为表单」(Quartz 下是「6/7 字段」)。原因通常只有两种:字段数不对,或者你贴的其实是另一种方言的表达式。这时候别硬拆,先把方言切对。
还有一种情况要留在高级模式:某些写法在表单里往返不了。 页面上的提示写得很直白——如果你用了表单无法完整往返表达的写法,就保持高级模式。原因是表单在生成时会对空值做兜底(留空变 * 或 0),某些精心写的表达式过一遍表单会被「规范化」,回来就不是原来那串了。工具不假装能往返,而是让你留在原地,这个取舍是对的。
📅 七个常见计划,表达式和解释一起给
下面这些是实际工作中出现频率最高的。每条都给两种方言的写法、中文解释,以及「要不要用预设」。
1. 每分钟
- Linux:
* * * * * - Quartz:
0 * * * * ? - 解释:每分钟执行一次。一天 1440 次。
- 预设:有(「每分钟」)。
Quartz 那条的秒位是 0,意思是每分钟的第 0 秒触发。如果写成 * * * * * ?,就变成每秒一次了,一天 86400 次。这是从 Linux 抄到 Quartz 时最容易出现的错误。
2. 每 5 分钟
- Linux:
*/5 * * * * - Quartz:
0 */5 * * * ? - 解释:每 5 分钟一次,落在 0、5、10……55 分,一小时 12 次,一天 288 次。
- 预设:有。
想改成每 10 分钟,就把 */5 换成 */10,别去动别的字段。
3. 每天 02:00
- Linux:
0 2 * * * - Quartz:
0 0 2 * * ? - 解释:每天凌晨两点整执行一次。
- 预设:没有,用「每天 09:00」把「时」改成 2。
Quartz 的日字段是 *、星期字段是 ?。如果两个都写 *,会触发「日与星期必须有一个为 ?」的校验——这是 Quartz 用户第一次用生成器最常撞的墙。
4. 工作日 09:30
- Linux:
30 9 * * 1-5 - Quartz:
0 30 9 ? * MON-FRI - 解释:周一到周五的 09:30:00 执行。
- 预设:没有「09:30」的预设,用「工作日 09:00」改「分」和「时」两个字段。
Quartz 里 MON-FRI 等价于 2-6(1 是周日,2 是周一)。写名称比写数字稳,因为两套方言的星期编号正好错开一位,数字记混了会静默跑错一天。
5. 每周一 09:00
- Linux:
0 9 * * 1 - Quartz:
0 0 9 ? * MON - 解释:每周一早上九点执行。
- 预设:有(「每周一 09:00」)。
Linux 的 1 是周一;同一位置的 1 在 Quartz 里是周日。这就是为什么在两种方言之间搬运表达式时,星期字段必须重新核对。
6. 每月 1 日 00:00
- Linux:
0 0 1 * * - Quartz:
0 0 0 1 * ? - 解释:每月第一天零点执行,一年 12 次。
- 预设:有(「每月 1 日 00:00」)。
Quartz 这条:日字段 1 指定了日期,星期字段就必须是 ?。写成 0 0 0 1 * * 是不合法的。
7. 每月最后一天 10:15(仅 Quartz)
- Quartz:
0 15 10 L * ? - 解释:每月最后一天 10:15:00 执行,日期由当月实际天数决定。
- 预设:没有,在高级模式里写,或用表单在「日」字段填
L。
Linux 五字段没有 L,做不到「每月最后一天」。真要这个语义,只能在脚本里判断,或者把任务挪到支持 L 的调度器上。生成器不会替你「翻译」这个需求,因为翻译不出来。
🔎 语义说明管到哪一步
生成器下面那块「语义说明」容易被高估。它覆盖的是一批常见模式:
- Linux:全星号 → 每分钟;
*/N→ 每 N 分钟;纯数字分 + 其余星号 → 每小时的某分;数字分数字时 → 每天 HH; - Quartz:全星号 +
?→ 每秒;0+*/N+?→ 每 N 分钟的第 0 秒;数字秒 + 其余星号 → 每分钟的第 N 秒;数字秒分时 → 每天 HH:mm。
超出这个范围,它会退回成一句更保守的话:按字段规则执行,然后把每个字段的原值逐条列出来。比如工作日 09:30 的 Quartz 写法,那句摘要不会写成「工作日早上九点半」,而是列出「秒 0 / 分 30 / 时 9 / 日 ? / 月 * / 星期 MON-FRI」。
这不是缺陷,是诚实。MON-FRI、1-5、L、W、# 这些组合翻成人话有太多歧义(比如 L 在日字段和星期字段意思不同),硬凑一句通顺的话反而误导人。所以核对的顺序应该是:先看字段解释,再看摘要。摘要用来快速确认整体节奏,字段解释才是逐位对账的依据。
校验部分同理,它只做「这串字符在这套方言里合不合法」,不做「这是不是你想要的」。0 0 3 * * ? 完全合法,含义是每天凌晨三点——如果你本意是「每月三号」,那就是需求错了,工具不会拦你。
⚠️ 五个容易翻车的细节
生成器能把表达式写对,但有几件事表达式本身表达不了。这些是生成之后仍然要自己判断的。
1. 工作日不等于节假日
MON-FRI、1-5 只认周一到周五。春节、国庆它照跑;调休上班的周六它照休。
这是 cron 的能力边界,不是实现缺陷。要按节假日调度,得在任务里判断交易日历,或者换用带节假日配置的调度系统。生成器页面上明确写了这一条,就是怕有人把「工作日」理解成「法定工作日」。
2. 每月 29/30/31 日,行为取决于调度器
0 0 3 31 * ? 只在有 31 号的月份跑:1、3、5、7、8、10、12 月。4、6、9、11 月和 2 月直接没有这一天。0 0 0 30 2 ? 更极端,2 月永远没有 30 号,一次都不会跑。
关键在于:当月没有这个日期时,不同调度器的处理不一样。 有的直接跳过,有的会被上层框架或包装库做归一化。Quartz 自己的经典行为是不触发,但各版本、各种封装都可能不同。
所以生成器只做提示,不会偷偷把 31 改成「月末」——那等于替你改了需求。要「每月最后一天」,Quartz 写 L,Linux 就只能在脚本里算。上线前一定要用未来执行预览看一遍,确认小月份的表现符合预期。
3. 0 和 7 都是周日
Linux 的星期字段是 0–7:0 和 7 都表示周日,1 到 6 是周一到周六。Quartz 是 1–7:1 是周日,7 是周六。
后果很具体:
- 想在周日跑,Linux 写
0(或7),Quartz 写1; - 想避开周末,Linux 写
1-5,Quartz 写2-6; - 同一个
7,在 Linux 是周日,在 Quartz 是周六,差一天。
用 SUN、MON 这类名称能规避一部分风险,但也别完全依赖——个别老实现不认名称别名。跨方言搬运时,星期字段永远重新核对一遍。
4. 时区由调度器决定,不由表达式决定
表达式里没有时区。0 0 2 * * ? 到底是几点,看谁在执行它:
- Linux crontab:按系统本地时区。容器里基础镜像默认 UTC 的情况极常见,于是「凌晨两点」实际跑在北京时间上午十点。部分发行版支持在 crontab 里用
CRON_TZ指定,但这是扩展,不是所有环境都认。 - Quartz:由
Scheduler的TimeZone决定,CronTrigger也可以单独指定。同一个 JVM 里可以同时存在按 UTC 和按 Asia/Shanghai 触发的任务。 - Kubernetes CronJob:按控制器所在时区解释,不写就按集群默认。
生成器只负责把表达式写对,时区得你自己确认。验证时把解析页的时区改成服务器实际用的那个,再算一遍,就能看出差多少。如果差值正好是整数小时,基本就是 UTC 和东八区的问题。
5. 密集表达式要提前算次数
- 每分钟:1440 次/天;
- 每 5 分钟:288 次/天;
- 每秒:86400 次/天。
前两个还算正常,第三个基本是事故。生成器本身不拦你,但带出到解析页后,若相邻两次执行间隔不到一分钟,会出现频率提醒。这个提醒的用处不是「警告你别写」,而是让你在贴到生产之前,先想一遍这频率下游接不接得住——接口限流、数据库写入、日志体积、监控告警,都在这条线上。
还有一条和 Linux 有关的语义,顺手记一下:Linux 里「日」和「星期」同时被限定时,关系是「或」。 0 2 1 * 1 的含义是「每月 1 号 或 每周一」的凌晨两点,不是「1 号且是周一」。生成器允许你这么写(它合法),但如果你要的是「1 号且是周一」,cron 表达不了,得在代码里判断。Quartz 那边没有这个问题,因为两个字段必须互斥。
✅ 生成完别急着贴,带出去跑一遍
页面底部有三个按钮,对应三种验证深度。
「解析字段」:带出到 Cron 表达式解析 的字段解读视图。适合想看清楚每一位到底怎么被解释的情况,方言会一起带过去,不用重选。
「查看下一次执行」:带出到解析页的执行计划视图,显示严格晚于基准时间的下一次。基准时间默认是当前时间,次数默认 5 次。
「预览未来执行」:同样是执行计划视图,但次数直接给到 20 次。这一条最实用,因为单看「下一次」看不出节奏问题,看 20 次就能看出规律。
带出之后,建议按这个顺序核三件事:
- 把时区改成服务器实际时区。 默认是本机时区,本机是东八区、服务器是 UTC 的话,差 8 小时。改完再看时间点,对得上才算过。
- 把基准时间设成一个有代表性的时刻。 比如「每月 1 日」的任务,基准设成 1 月 20 日,看它下一次是不是落在 2 月 1 日;「每月 31 日」的任务,基准设成 4 月初,看它是不是直接跳到 5 月 31 日。
- 看整段窗口的分布。 20 次是连续的执行点,跨月、跨年、跨夏令时的表现都在里面。工作日任务可以顺便确认周六周日确实没出现。
如果解析页里发现表达式要改,不用切回生成器重新填——解析页上有「用生成器编辑」,点一下就把表达式和方言带回生成器,拆进表单继续调。这条链路是通的:写 → 验 → 改 → 再验,全程在浏览器本地完成,表达式和基准时间都不上传。
贴回环境的时候还有两个手工环节,工具管不了:
- crontab 只认五段。 六字段表达式贴进去,多出来的那一段会被当成命令的一部分,任务根本不执行,甚至可能报「命令找不到」。
@Scheduled需要六段。 少一段在启动阶段就会失败。Quartz 的七段带年份,只在确实要限定年份时用。
复制过去的是一串纯表达式,方言不会跟着一起复制。所以贴到工单、文档、交接记录里的时候,自己注明一句「Linux 五字段」或「Quartz 六字段」,能省掉后来人半小时的猜。
❓ 常见问题
生成的表达式能直接用在 Spring 的 @Scheduled 上吗?
先看版本。`@Scheduled(cron = "...")` 用的是六段表达式(秒 分 时 日 月 星期),所以只有 Quartz 方言生成的那一版字段数才对,Linux 五字段贴进去会直接启动失败。但 Spring 的解析器并不是 Quartz 本身:Spring 5.3 起改用 `CronExpression`,支持 `?`、`L`、`W`、`#`;更早版本的 `CronSequenceGenerator` 不支持这些扩展字符,遇到会报错。跨版本部署时,先在测试环境启动一次,比在生产上试便宜。为什么一切换方言,表单里的内容就没了?
因为两种方言的字段位置和取值范围都不同,把 Linux 的五个值硬塞进 Quartz 的六个位置只会得到含义错误的表达式。切换时重置为默认值,是避免静默错位。如果你已经有一段贴好的表达式,先复制出来,切完方言再贴进「高级」用「同步到表单」拆回去。每月 31 日的任务,2 月会怎样?
2 月没有 31 日,所以这个月不会触发。具体是直接跳过、顺延到月末还是别的方式,取决于调度器和方言实现,不同实现存在差异。生成器只提示,不会把 31 自动改成「月末」。要「每月最后一天」,Quartz 用 `L`;Linux 五字段做不到,只能在脚本里判断。「工作日」会自动跳过法定节假日吗?
不会。`MON-FRI`、`1-5` 只表示周一到周五,节假日和调休一概不知。五一假期里任务照跑,调休上班的周六它照休。需要按节假日调度,只能在任务内部判断交易日历,或者换用支持节假日配置的调度系统。秒字段可以写 60 吗?
不行。Quartz 的秒范围是 0–59,写 60 会被判定超出范围并报错。如果你想要「每分钟的最后一次」,那是另一回事,得换思路或用代码控制。生成器不会替你回绕成 0——静默回绕比报错危险得多。每天 2 点、工作日 9:30 为什么不在预设里?
预设只覆盖结构(每分钟、每 5 分钟、每小时、每天、每周、每月、每月 1 日),具体时刻通过表单填。每天 2 点用「每天 09:00」把「时」改成 2;工作日 9:30 用「工作日 09:00」把「分」改成 30、「时」改成 9。两三次输入,比维护一长串预设更实用。写进去的表达式会被上传吗?
不会。生成、校验、语义说明、带出到解析页,全部在浏览器本地完成,不产生网络请求。内部的定时任务表达式往往涉及系统结构和运维节奏,这一点值得留意。收个尾
生成器解决的是「写」这件事:方言先定,结构用预设,时刻用表单填,特殊写法走高级,每一步都实时校验、给解释。它不解决「这是不是你想要的」——那需要你带着时区、带着业务日历、带着对调度器行为的了解,去核对未来执行。
所以最稳的用法是两步:在 Cron 表达式生成器 里把表达式拼出来,再带出到 Cron 表达式解析 里看它未来 20 次落在什么时候。前者保证字符没错,后者保证语义没错。两件事都过了,再往 crontab 或 @Scheduled 里贴。
如果你手上还有一堆看不懂的老表达式,解析页的字段解读能帮上忙;时间系列其他工具(时间戳、时区转换、日期计算)的分工,可以看 星点时间工具完整指南;想系统搞清楚每个字段和每个符号,可以再读 Cron 表达式解析指南——那篇讲怎么读,这篇讲怎么写,配着用刚好。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!