Cron表达式生成器 - 在线生成Linux/Quartz定时任务表达式

5815 字
29 分钟
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 / crontabQuartz
字段数56,或 7(带年)
最小粒度1 分钟1 秒
字段顺序分 时 日 月 星期秒 分 时 日 月 星期
星期的值0–7,0 和 7 都是周日1–7,1 是周日
?不支持支持,只能用在「日」和「星期」
L W #不支持支持
日与星期同时限定允许,语义是「或」不允许,必须有一个写 ?

同一句需求,两种写法摆一起#

下面是日常最常配的几条,左边可以直接贴 crontab,右边可以直接贴 @Scheduled 或 CronTrigger:

计划Linux 五字段Quartz 六字段
每天 02:000 2 * * *0 0 2 * * ?
工作日 09:3030 9 * * 1-50 30 9 ? * MON-FRI
每周一 09:000 9 * * 10 0 9 ? * MON
每月 1 日 00:000 0 1 * *0 0 0 1 * ?
每 5 分钟*/5 * * * *0 */5 * * * ?

对照着看,会发现两边的差异不是「整体右移一位」那么简单。Quartz 除了在开头补一个秒位,还得在「星期」被限定时把「日」改成 ?。所以 0 2 * * * 对应的不是 0 0 2 * * *,而是 0 0 2 * * ?——后面那个 * 会让表达式直接不合法。抄的时候只想着「前面加个 0」,必错。

正因为这样,生成器把方言做成了一个必须显式选择的开关,而不是自动猜。选错方言,工具不会帮你「兼容」,它只会按你选的那一套校验,把不合适的地方标出来。

一个操作细节先提醒:在生成器里切换方言,表单会被重置成该方言的默认值,高级输入框也会跟着重置。 这不是 bug——把 Linux 的字段值硬塞进 Quartz 的六个位置,只会得到一串看起来合法、含义全错的表达式。如果你手上已经有一段贴好的表达式,先复制出来,再切方言。

🛠 三样东西:预设、表单、高级#

页面上真正的输入方式有三种,各管一段。

预设:从一个最接近的计划开始#

下拉里有七条:

预设LinuxQuartz
每分钟* * * * *0 * * * * ?
每 5 分钟*/5 * * * *0 */5 * * * ?
每小时0 * * * *0 0 * * * ?
每天 09:000 9 * * *0 0 9 * * ?
工作日 09:000 9 * * 1-50 0 9 ? * MON-FRI
每周一 09:000 9 * * 10 0 9 ? * MON
每月 1 日 00:000 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 里日与星期同时指定,都会分别指出来。

有两个行为值得知道:

  1. 字段留空等于取任意值。 把「分」清空,生成时会当成 *;Quartz 的秒留空会当成 0,星期留空会当成 ?。不会报错,但结果可能不是你想要的,填完扫一眼表达式再走。
  2. 「年」留空表示不限年份。 填 * 也一样会被当成空,不会生成七字段。只有填了具体年份(或多个年份)才会补上第七段。

高级:直接贴,再同步回表单#

手上有现成表达式、或者写法超出表单能表达的范围时,切到「高级」,把表达式贴进去。校验、语义说明、带出验证这些能力全都还在,只是不再用字段拼。

高级模式最有用的按钮是「同步到表单」:它按当前方言的字段数把表达式拆回各个输入框,然后切回表单模式。适合这两种情况:

  • 别人给了你一行表达式,你想改成别的时刻,但懒得逐字符数位置;
  • 你在高级里试了几种写法,最后想固定下来,回到表单里可视化地调。

拆不动会直接报错,提示「无法按 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 次就能看出规律。

带出之后,建议按这个顺序核三件事:

  1. 把时区改成服务器实际时区。 默认是本机时区,本机是东八区、服务器是 UTC 的话,差 8 小时。改完再看时间点,对得上才算过。
  2. 把基准时间设成一个有代表性的时刻。 比如「每月 1 日」的任务,基准设成 1 月 20 日,看它下一次是不是落在 2 月 1 日;「每月 31 日」的任务,基准设成 4 月初,看它是不是直接跳到 5 月 31 日。
  3. 看整段窗口的分布。 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 表达式解析指南——那篇讲怎么读,这篇讲怎么写,配着用刚好。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

相关文章 智能推荐
1
Cron表达式解析器 - 字段解读、下次执行时间与Quartz/Linux方言
时间工具 在线 Cron 表达式解析指南:讲清 Linux 五字段与 Quartz 六/七字段的区别、各字段允许值与 * , - / ? L W
2
星点时间工具完整指南 - 时间戳/时区/日期计算/Cron 8个在线工具导航
时间工具 星点时间工具系列完整指南:时间戳转换、时区转换、日期时间格式化、时间差与日期差、日期计算器、时间字符串解析、Cron 表达式解析与生成共 8 个在线工具一站式导航。含按场景选工具、时间戳/UTC/IANA 时区/RFC3339/日历日/DST 概念对照表、三个典型工作流、五个常见误区与 FAQ,全部浏览器本地计算不上传。
3
在线时区转换工具 - 多时区对照、UTC与夏令时一次看清
时间工具 在线时区转换工具使用指南:输入源时间与源时区,看清同一瞬间在多个 IANA 时区的当地时间、UTC、RFC3339 与 Unix 时间戳,支持排序、收藏与复制。讲清 IANA 时区与固定偏移的区别、夏令时春季缺失与秋季重复的时间、南半球相反规则,以及把 UTC 当北京时间减 8 小时、CST 歧义、跨日与日期变更线等错误,附五类时间表示对照表与 FAQ。
4
时间差/日期差计算器 - 相隔天数、年月差与真实经过时长
时间工具 在线时间差与日期差计算器:把「两个时刻真实经过了多久」和「两个日期相差几天、几个月」分开算。时刻差给出总毫秒/秒/分/时/天与天时分秒分解,跨夏令时按实际经过;日期差给出相隔天数、周+余天、完整年月日与近似总月/年,可含起止日期。含两种口径对比表、跨夏令时实例、五个常见错误与操作步骤,浏览器本地计算。
5
日期计算器 - 日期加减与未来日期推算(月末钳制、闰年规则)
时间工具 在线日期计算器使用指南:从基准日期或日期时间加减年、月、周、日、时、分、秒,推算合同到期、保质期截止、项目排期与纪念日。讲清月末钳制(1 月 31 日加一个月得 2 月最后一天)、闰年 2 月 29 日加一年落到 2 月 28 日的原因,以及「加一天」不等于「加 24 小时」的日历日与固定时长差别,附操作步骤、单位对照与常见错误。
随机文章 随机推荐
公告
🎉 已升级 2.0 版本,欢迎使用。
分类
标签
站点统计
文章
247
分类
31
标签
973
总字数
633,901
运行时长
0 天
最后活动
0 天前

目录