Cron expression explainer

Paste a crontab schedule to read it in plain words, see when it runs next in UTC or your time zone, and get heartbeat settings that alert you when a run goes missing.

cron 表达式解析

粘贴 crontab 时间表达式，用通俗的话读懂它，查看它接下来在 UTC 或你所在时区的运行时间，并得到在任务漏跑时提醒你的心跳监控设置。

Cron syntax

A cron expression has five fields separated by spaces. In a crontab file the command follows them on the same line.

┌──────── minute (0–59)
│ ┌────── hour (0–23)
│ │ ┌──── day of month (1–31)
│ │ │ ┌── month (1–12 or JAN–DEC)
│ │ │ │ ┌ day of week (0–7 or SUN–SAT, 0 and 7 are Sunday)
│ │ │ │ │
* * * * * command

Shorthands

Most cron implementations accept these in place of the five fields:

Common schedules

Mistakes that catch people out

• Day of month or day of week: When both fields are restricted, a day that matches either one runs. 0 0 13 * 5 runs on every 13th and every Friday. To run only on Friday the 13th, schedule every Friday and check the date in the script.
• Steps restart every hour: */7 in the minute field runs at 0, 7 … 56 and again at 0, so the last gap of each hour is 4 minutes. The tool shows the shortest and longest gap for every schedule.
• Which time zone: Cron uses the time zone of the machine or of the scheduler, which is often UTC on servers and in containers. Check it before you pick an hour.
• Daylight saving time: When clocks change, a job in the skipped hour can run late or not at all, and one in the repeated hour can run twice, depending on the implementation. Schedule in UTC, or keep daily jobs out of 01:00 to 03:00 local time.
• The crontab line itself: Cron starts jobs with a short PATH and few environment variables, so use full paths. An unescaped % in the command is read as a new line; write \%.

Cron in other schedulers

• Kubernetes CronJob: Uses these five fields and the shorthands. Set spec.timeZone to a name such as Europe/Berlin; without it the schedule follows the time zone of the controller manager.
• GitHub Actions: on.schedule uses these five fields in UTC. The shortest interval is every 5 minutes, and runs can start late when GitHub is busy.
• Quartz and Spring: Add a seconds field at the start (and Quartz an optional year at the end), need ? in one of the two day fields, and support L, W and #. In Quartz, day of week 1 is Sunday.
• AWS EventBridge: Writes cron(minutes hours day-of-month month day-of-week year) with six fields, needs ? in one day field and counts days of the week from 1 for Sunday.

This tool reads the standard five fields and explains what to change when you paste a Quartz or AWS schedule.

0 9 * * 1-5 /usr/local/bin/report.sh && curl -fsS -m 10 --retry 3 https://openuptime.app/api/heartbeat/<token> > /dev/null

Questions

All free toolsHeartbeat APISLA and uptime calculatorWebsite down checkerSSL certificate checkerDNS lookup

cron 语法

cron 表达式由空格分隔的五个字段组成。在 crontab 文件里，要执行的命令写在同一行的后面。

┌──────── 分钟（0–59）
│ ┌────── 小时（0–23）
│ │ ┌──── 日期（1–31）
│ │ │ ┌── 月份（1–12 或 JAN–DEC）
│ │ │ │ ┌ 星期（0–7 或 SUN–SAT，0 和 7 都是周日）
│ │ │ │ │
* * * * * 命令

简写

大多数 cron 实现都接受用下面的简写代替五个字段：

常用时间表

容易踩的坑

• 日期和星期是“或”的关系: 同时限制这两个字段时，满足任意一个的日子都会运行。0 0 13 * 5 会在每月 13 日和每个周五运行。如果只想在“13 号星期五”运行，就安排在每个周五，再在脚本里判断日期。
• 步长每小时重新开始: 分钟字段写 */7 会在第 0、7……56 分钟运行，然后又从 0 开始，所以每小时最后一段间隔只有 4 分钟。本工具会显示每个时间表的最短和最长间隔。
• 用的是哪个时区: cron 使用机器或调度器的时区，服务器和容器里通常是 UTC。选定小时之前先确认时区。
• 夏令时: 时钟调整时，被跳过的那一小时里的任务可能延后或不运行，重复的那一小时里的任务可能运行两次，具体取决于实现。用 UTC 安排，或者让每天的任务避开当地时间 01:00 到 03:00。
• crontab 这一行本身: cron 启动任务时 PATH 很短、环境变量很少，所以请使用完整路径。命令里未转义的 % 会被当成换行，要写成 \%。

其他调度器里的 cron

• Kubernetes CronJob: 使用同样的五个字段和简写。可以把 spec.timeZone 设为 Asia/Shanghai 这样的时区名；不设置时按 controller manager 的时区执行。
• GitHub Actions: on.schedule 使用这五个字段，按 UTC 执行。最短间隔是 5 分钟，GitHub 繁忙时运行可能会延迟。
• Quartz 和 Spring: 开头多一个秒字段（Quartz 末尾还可以有年份），两个日期字段中必须有一个写 ?，并支持 L、W 和 #。在 Quartz 中，星期的 1 表示周日。
• AWS EventBridge: 写成 cron(分钟 小时 日期 月份 星期 年份) 共六个字段，一个日期字段必须写 ?，星期从 1 表示周日开始计数。

本工具读取标准的五个字段；粘贴 Quartz 或 AWS 的表达式时，会提示需要改哪里。

0 9 * * 1-5 /usr/local/bin/report.sh && curl -fsS -m 10 --retry 3 https://openuptime.app/api/heartbeat/<token> > /dev/null

常见问题

全部免费工具心跳 APISLA 与可用率计算器网站宕机检测SSL 证书检测DNS 查询