开发 首页 工具

Cron 表达式生成与解析工具

支持 23 种 cron 方言(Linux crontab、Kubernetes、Spring、Quartz、AWS 等),逐字段给出人话解释与未来触发时间,并列出同一串表达式在其它方言下的不同含义。

← 全部工具

表达式

快速生成

    下次触发

      常见问题

      支持哪些 cron 方言?默认是哪个?

      一共 23 种:Linux crontab(Vixie / cronie)、BSD cron(FreeBSD)、Kubernetes CronJob、Spring 5.3 及以后、Spring 5.2 及更早、Quartz、Quartz.NET、AWS EventBridge 与 CloudWatch、GitHub Actions、GitLab CI、Jenkins、robfig/cron v3(Go)、node-cron v4、cron(npm,kelektiv 维护)、croner、croniter(Python)、APScheduler 3.x、Celery beat、PHP cron-expression(Laravel)、NCrontab、Hangfire、cron4j、Rust cron。默认方言是 Linux crontab。同一串表达式在不同方言里的含义与下次运行时间都可能不同,选错方言就会算出错误的时间。最后一个只在服务器上才会遇到的差别:系统级文件(/etc/crontab 和 /etc/cron.d/ 下的文件)在五个时间字段之后、命令之前多一个用户名字段,用户自己的 crontab -e 没有这一段。

      0 0 12 * * ? 在 Spring 和 Quartz 里是不是一回事?

      这一串两边都表示每天 12:00:00,看不出差别:字段结构相同(6 个字段,秒在最前),日写 *、周写 ? 在两边都是合法写法。差别藏在星期编号里:Spring 是 0-7,0 与 7 都表示周日;Quartz 是 1-7,1 表示周日并且没有 0。只要把周位换成数字就会分叉——0 0 12 * * 1 在 Spring 是周一 12:00,在 Quartz 是周日 12:00;0 0 12 * * 0 在 Quartz 里是非法值。另外 Quartz 要求日与周至少有一个写 ?(这串刚好满足),而 Spring 里 ? 只是可选的 * 别名。

      为什么 */35 * * * * 不是「每 35 分钟」?

      因为 */n 的规则是「在字段的取值范围内跳」,不是滚动间隔。分钟字段的范围是 0-59,*/35 取到的是 0 和 35:0 分之后隔 35 分钟到 35 分,再到下一个 0 分只隔 25 分钟,间隔在 35 与 25 之间交替。日字段同理,*/2 得到的是 1、3、5、7…31,也就是奇数日,不是「每两天」。Hangfire 的官方帮助里专门提醒:只有能整除 60、24、30、12 的步长才符合直觉。

      日和周两个字段同时都写了限定值,是「或」还是「与」?

      要看方言。Linux crontab、PHP cron-expression、croniter 默认是「或」:两个字段任一条满足就触发。cron4j、node-cron v4,以及 croner 用了加号之后是「与」:必须同时满足。Quartz 和 AWS 是第三种处理——它们不允许日与周都设限,要求至少有一个写 ?,所以在这两个方言里「与」根本表达不出来。两个字段都写 * 时表示都不限,不存在或与的区别;只有一个字段受限、另一个写 * 时,「与」和「或」算出来是同一个结果,也没有区别。

      ? 什么时候是必需的,什么时候不能写?

      必需:Quartz、Quartz.NET、AWS。这三个方言里日与周至少有一个必须是 ?,日写 * 时周就得是 ?,两个都写数字会被判非法。可选:Spring、PHP cron-expression、NCrontab、Kubernetes,这里的 ? 就是 * 的别名,写不写都一样。不能写:Linux crontab 和 Jenkins 完全不支持 ?,写了是语法错误,不会被忽略。robfig/cron v3 是另一个极端,它只认 ?,没有 L、W、#。

      L、W、# 分别是什么?哪些方言没有?

      这三个都是 Quartz 那一族的扩展写法:L 与「最后」有关(cron4j 的 L 明确只表示月末),W 与「工作日」有关,两者还能组合成更细的粒度;# 表示第 n 个星期几,比如当月第一个周一。支持它们的有 Quartz、Quartz.NET、Spring 5.3 及以后(5.2 及更早不支持 L 和 W)、AWS、PHP cron-expression、node-cron v4、croniter。完全不支持的是 Linux crontab、Kubernetes、Jenkins、NCrontab、Celery beat,在这些方言里写 L、W、# 是语法错误,不会被忽略。GitLab CI 另有一套 fugit 扩展:# 表示第 n 个星期几,百分号表示隔 n 周,别的方言解析它同样会判非法。这些字符的具体语义以对应库的官方文档为准。

      Kubernetes 里为什么不能写 TZ= 前缀?

      因为 K8s 把 schedule 里出现的 TZ= 与 CRON_TZ= 前缀当作非法写法硬拒,时区只能写在 .spec.timeZone 里。这一点和 Linux crontab 正好相反,crontab 是可以用 CRON_TZ 覆盖时区的。另外 K8s 的 schedule 只收 5 个字段,多写一个秒级字段也会被拒;它支持的宏只有 @yearly、@annually、@monthly、@weekly、@daily、@hourly 这六个,@every 不在其中。

      Jenkins 的 H 是什么?为什么算不出它下次运行的确切时间?

      H 是 hash:它把「一个由 job 名算出来、每次都一样的时刻」写进表达式,最终落在哪一分钟由 job 名决定。所以 H 3 * * * 的正确读法是「03 点里的某个时刻」——同一个 job 每次算出来都一样,但没有 job 名就定不下确切分钟,只能给出时间区间。Jenkins 的宏也带 hash 语义,@hourly 等于 H * * * *,并不是整点。

      @daily 这类宏哪些方言支持、哪些明确不支持?@reboot 为什么没有下次运行时间?

      支持宏的有 Linux crontab、BSD cron(另有 @midnight、@every_minute、@every_second)、Kubernetes(那六个宏,没有 @every)、Jenkins(带 hash 语义,@hourly 等于 H * * * *)、PHP cron-expression、robfig/cron v3(另有 @every)、croniter、croner(但 @reboot 会报错);明确不支持的是 Quartz(Java 版)、GitHub Actions、NCrontab、Celery beat,写宏就是语法错误,Spring 5.3 及以后有 @yearly 到 @hourly 但没有 @reboot,Spring 5.2 及更早没有宏,Quartz.NET 3.x 没有宏、4.x 起才有,Hangfire 也不是宏、周期要用 Cron.Daily() 这类 C# 方法写。在这一堆宏里 @reboot 最特殊:它只在系统开机时执行一次,不挂在任何日历时刻上,按分钟往下推出来的「下次运行时间」一定是错的,所以它给不出「下次运行时间」。

      哪些写法看起来像 cron 但不是 cron?

      最容易混进来的是 systemd 的 OnCalendar=:它的字段顺序是「星期、年-月-日、时:分:秒」(例如 OnCalendar=Mon *-*-1 00:00:00),还有 minutely 到 yearly 这组别名,以及用波浪号表示当月倒数第几天,它不是 cron 表达式,要按 systemd 自己的写法写;AWS 的 rate(5 minutes) 与 at(2022-11-20T13:00:00) 同样是另一种表达式,其中 rate 的单位只能是 minute(s)、hour(s)、day(s),数量为 1 用单数、大于 1 用复数,它表示固定长度的时间间隔而不是日历上的某个时刻(rate(1 day) 是「每 24 小时」,不落在每天 0 点),所以它推不出「下次运行时间」,at 则只跑一次并忽略 StartDate 与 EndDate;再往下还有 Anacron(/etc/anacrontab),它用「周期天数加延迟」描述,只在开机时补跑错过的任务,不保证精确时刻,以及 Windows 任务计划——它根本没有 cron 字符串,用的是 XML 强类型触发器(DailyTrigger、WeeklyTrigger 等)。

      秒级任务:哪些方言支持秒,秒在第几个字段?

      秒在第 1 个字段的:Spring 5.3 及以后与 5.2 及更早(都是固定 6 字段)、Quartz 与 Quartz.NET(6 或 7 字段,第 7 个是年)、cron(npm,kelektiv 维护,固定 6 字段)、Rust cron(6 或 7 字段),以及开了秒选项之后的 robfig/cron v3、node-cron v4、croner、NCrontab。没有秒的:Linux crontab、Kubernetes、AWS(它的第 1 个字段是分,不是秒)、GitHub Actions、Jenkins、PHP cron-expression、Celery beat、Hangfire、cron4j。croniter 是特例:默认 5 个字段,多给出来的第 6 个字段才是秒,而且排在最后,要 second_at_beginning=True 才会挪到最前。

      有没有「我以为对但其实错」的常见例子?

      最典型的是 0 0 9 * * 1:在 Linux crontab、Spring、Jenkins、PHP 里是周一 09:00,在 Quartz 和 Quartz.NET 里是周日 09:00(那边 1 表示周日、没有 0),在 AWS 里直接非法——AWS 要 6 个字段且最后一个是年,日与周还必须有一个写 ?。第二个是 */35 * * * *,看着像「每 35 分钟」,实际只落在每小时的 0 分和 35 分。第三个是 GitHub Actions 里写 */2 * * * *,间隔小于 5 分钟的调度会被忽略,等于白写。