如何验证 cron 表达式并查看未来五次运行时间
输入正好五个字段的 cron 表达式,即可验证它并查看从当前 UTC 时间起的后续五次运行时间。结果以标明 UTC 的 ISO 日期时间字符串返回,找不到十年内的下一次匹配时也会失败。
先了解它能做什么
这个工具用于检查五字段 cron 表达式,并在计算成功时列出从当前 UTC 时间起、即将发生的五次运行时间。它适合在编写定时任务后,先确认字段数量、字段顺序和日历匹配结果,再安排后续任务。输入前后多余空格会被去除,连续空白会按单个空格处理。
操作步骤:输入并检查 cron 表达式
-
在输入框中填写五字段 cron 表达式。字段顺序依次是:分钟、小时、日期中的日、月份、星期几。表达式必须正好包含五个由空白分隔的字段;字段数量不符时,会在计算前返回失败。
-
如果暂时不填写表达式,工具会使用默认值
*/5 * * * *。如果填写自己的表达式,可在提交前检查是否误用了六字段格式,或把小时和分钟的位置写反。 -
提交表达式进行验证和计算。工具从当前 UTC 时间开始计算,并去掉当前时间的小数秒,然后寻找接下来的五次日历发生时间。
-
查看返回结果。成功时,五个时间会以 ISO 格式显示,并标明 UTC 时区。若日期中的日和星期几同时设置了限制,两者采用“或”关系:满足其中一个条件即可匹配。
如何理解结果与失败
成功结果表示表达式通过了五字段格式和相关值的解析,并找到了五个后续日历发生时间。时间应按 UTC 阅读;如果要用于本地任务计划,需要自行换算时区。
失败不只代表语法写错。语法、日期、数值或键解析出现受处理的错误时,工具会返回失败;即使表达式语法有效,如果未来十年内找不到下一次匹配,也会失败。因此,看到失败时应同时复查字段数量、取值范围、日历条件,以及任务间隔是否超出十年的搜索范围。五字段格式也不等于支持所有 cron 方言。
使用示例
你想检查一个每月第一天 UTC 零点运行的计划,并确认工具返回未来五次发生时间。
输入 0 0 1 * * 并提交验证,随后查看返回的五个时间项。
结果应为五个后续日历发生时间,并以标明 UTC 时区的 ISO 日期时间字符串显示。
使用限制
- 该工具的已确认行为仅覆盖五字段 cron 表达式和十年搜索范围;资料没有确认六字段表达式、其他 cron 方言或更长间隔的兼容性。
常见错误
- 把秒字段加入表达式,或误排分钟与小时的位置,会导致字段数量或字段含义不符合要求。请保留五个字段,并按“分钟、小时、日期中的日、月份、星期几”的顺序重新检查。
常见问题
不输入 cron 表达式会发生什么?
未填写表达式时,工具使用 */5 * * * * 作为默认值;填写后则按输入内容验证和计算。
cron 表达式中有多余空格还能解析吗?
可以输入带有前后空格或连续空白的表达式,因为验证前会去除首尾空格,并将连续空白规范为单个空格。表达式本身仍必须包含正好五个字段。
日期中的日和星期几会同时生效吗?
当日期中的日和星期几都有限制时,匹配采用“或”关系,而不是必须同时满足。