WebGroundwebground.app
信息与指南 · 开发者参考

Cron 表达式指南与执行计划解析器

通过常见示例了解 cron 计划语法,并粘贴任意五字段表达式进行校验,查看它接下来的运行时间。

检查 Cron 表达式

五个以空格分隔的字段:分钟、小时、日期、月份、星期。

有效的 Cron 表达式

逐字段解析

  • 分钟

    允许的值:0 到 59

    值
    */15
    匹配
    • 0
    • 15
    • 30
    • 45
  • 小时

    允许的值:0 到 23

    值
    9-17
    匹配
    • 9 到 17
  • 日期

    允许的值:1 到 31

    值
    *
    匹配
    每月的每一天
  • 月份

    允许的值:1 到 12

    值
    *
    匹配
    每个月
  • 星期

    允许的值:0 到 7

    值
    MON-FRI
    匹配
    • 星期一 到 星期五

接下来的运行时间

常用计划

  • * * * * *
    运行时间
    每分钟
    快捷写法
  • */5 * * * *
    运行时间
    每 5 分钟
    快捷写法
  • */30 * * * *
    运行时间
    每 30 分钟
    快捷写法
  • 0 * * * *
    运行时间
    每小时整点
    快捷写法
    @hourly
  • 0 */6 * * *
    运行时间
    每 6 小时,从午夜开始
    快捷写法
  • 0 0 * * *
    运行时间
    每天午夜
    快捷写法
    @daily
  • 30 8 * * *
    运行时间
    每天上午 8:30
    快捷写法
  • 0 9 * * 1-5
    运行时间
    周一至周五上午 9:00
    快捷写法
  • 0 0 * * 0
    运行时间
    每周日午夜
    快捷写法
    @weekly
  • 0 0 1 * *
    运行时间
    每月第一天的午夜
    快捷写法
    @monthly
  • 0 0 1 */3 *
    运行时间
    一月、四月、七月和十月第一天的午夜
    快捷写法
  • 0 0 1 1 *
    运行时间
    每年 1 月 1 日午夜
    快捷写法
    @yearly

特殊字符

  • *
    含义
    该字段的所有值。
    示例
    * * * * *
  • ,
    含义
    由多个单独的值组成的列表。
    示例
    0 9,18 * * *
  • -
    含义
    一个取值范围,包含两端的值。
    示例
    0 9-17 * * *
  • /
    含义
    步长:从范围的起点算起,每 n 个值取一个。
    示例
    */10 * * * *

Cron 表达式的构成

cron 表达式由五个用空格分隔的字段组成:分钟、小时、日期、月份和星期。每个字段规定任务可以在何时运行,任务会在所有字段都匹配的每一分钟运行。

一个字段可以是单个数字、表示所有值的星号、用逗号分隔的列表、用连字符表示的范围,或者用斜杠表示的步长。月份和星期也可以写成三个字母的英文名称,例如 JAN 或 MON。

容易出错的地方

看起来没问题的计划,仍然可能在意想不到的时间运行。

  • cron 使用服务器的时区,它可能与您的时区不同。上方的运行时间使用的是您设备的时区。
  • 当日期和星期两个字段都设置了值时,只要其中一个匹配,任务就会运行。
  • 在星期字段中,0 和 7 都表示星期日。
  • */7 这样的步长会在每个新的小时、日或月重新开始计数,因此间隔并不总是均匀的。

常见问题 (FAQ)

为什么我的六字段表达式被拒绝?+

Linux 和 macOS 上的标准 cron 使用五个字段。六个或七个字段的表达式来自 Quartz、Spring 等调度器,它们增加了一个秒字段,有时还有年份字段,并使用 ? 和 L 等额外的符号。

@daily 这样的快捷写法是什么意思?+

它们是常用计划的简称。@hourly、@daily、@weekly、@monthly 和 @yearly 分别在每小时、每天、每周、每月或每年开始时运行。@reboot 只在系统启动时运行一次,因此没有可显示的运行时间。

我输入的表达式会被发送到别处吗?+

不会。表达式的校验和运行时间的推算都在您的浏览器中完成。

探索更多 WebGround 工具

查看全部