PlayTools

Cron 表达式与调度注意

可视化构建和验证 Cron 计划任务,并以通俗语言描述计划内容,生成可直接复制的表达式。

Runs in your browser — nothing you enter is uploaded
* * * * *

every minute

Common presets

Minute(0–59)
*
Hour(0–23)
*
Day of Month(1–31)
*
Month(1–12)
*
Day of Week(0–6)
*

Cron format reference

┌── minute (0–59)
│ ┌── hour (0–23)
│ │ ┌── day of month (1–31)
│ │ │ ┌── month (1–12)
│ │ │ │ ┌── day of week (0–6, Sun=0)
│ │ │ │ │
* * * * *
*Every value
*/nEvery n-th value
a-bRange from a to b
a,b,cSpecific values
1-5Monday to Friday
0 0 * * *Daily at midnight

Cron 表达式与调度注意

Cron 由分、时、日、月、周几等字段组合;夏令时会导致当地墙钟任务偏移,基础设施任务可尽量用 UTC。

不同平台可能有 Quartz 扩展,上线前请在预发验证。

Reading a cron expression

┌───────── minute (0–59)
│ ┌─────── hour (0–23)
│ │ ┌───── day of month (1–31)
│ │ │ ┌─── month (1–12)
│ │ │ │ ┌─ day of week (0–6, Sunday = 0)
│ │ │ │ │
0 9 * * 1-5   → 09:00, Monday to Friday

Each field accepts * (every value), a single number, a list (1,15), a range (9-17) or a step (*/15). The builder writes these for you and shows a plain-English description of the schedule, so you can confirm it before pasting it into crontab or a CI configuration.

Worked examples

  • */15 9-17 * * 1-5 — every 15 minutes from 09:00 to 17:45, weekdays only (the last run is 17:45 because the hour field stops at 17).
  • 30 2 * * 0 — 02:30 every Sunday, a common slot for weekly maintenance.
  • 0 0 1 * * — midnight on the first day of every month, for monthly reports.
  • 0 9,18 * * * — 09:00 and 18:00 every day.
  • 0 0 1 1 * — once a year at midnight on 1 January.

Gotchas that cause missed or duplicate runs

  • Day of month OR day of week: when both fields are restricted, standard cron runs when either one matches. 0 0 13 * 5 runs on every 13th and on every Friday, not only on Friday the 13th.
  • Uneven steps: */7 in the minute field runs at :00, :07 … :56 and then :00 again, leaving a 4-minute gap each hour. Steps only divide evenly when they are factors of 60 (minutes) or 24 (hours).
  • Daylight saving time: in a local time zone, jobs scheduled between 01:00 and 03:00 can be skipped or run twice on the nights the clocks change, depending on the cron implementation. Schedule critical jobs in UTC or outside that window.
  • Time zone of the server: crontab uses the machine’s time zone; GitHub Actions schedules always run in UTC; Kubernetes CronJobs can set an explicit timeZone.
  • Last day of the month: standard cron has no syntax for it. Run daily on the 28th–31st and check in the script whether tomorrow is the 1st.

Cron dialects

  • Standard (Vixie) cron and most Linux systems: the five fields shown here. Many also accept 7 for Sunday and three-letter names (MON, JAN).
  • Quartz (Java) and Spring: six or seven fields, starting with seconds, and ? for “no specific value” in day-of-month or day-of-week.
  • AWS EventBridge: six fields including a year, and one of the two day fields must be ?.
  • GitHub Actions: standard five fields in UTC, with runs no more often than every 5 minutes and possible delays at busy times.

Paste the five-field output from this tool as-is into crontab, GitHub Actions or Kubernetes; for Quartz or EventBridge, add the extra fields their syntax requires.

Making a cron job run reliably

  • Run the command by hand first, as the same user cron will use.
  • Use absolute paths: cron starts jobs with a minimal environment and a short PATH, so commands that work in your shell may not be found.
  • Capture output, e.g. 0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1, otherwise errors are mailed to a local mailbox nobody reads, or lost.
  • Prevent overlaps for long jobs with a lock, for example flock -n /tmp/backup.lock /usr/local/bin/backup.sh.

In-depth guides

These free tools pair well with this page — open them in a new tab to finish your workflow.

常见问题

什么是cron表达式?

cron表达式是由5个字段组成的字符串(分钟、小时、日期、月份、星期),定义了一个周期性计划。Unix cron、GitHub Actions、云调度器等众多系统使用它在指定时间自动运行任务。

cron中的星号(*)表示什么?

星号(*)表示「每个值」。例如,分钟字段中的*表示「每分钟」,小时字段中的*表示「每小时」。它是匹配该位置所有有效值的通配符。

如何每15分钟运行一次任务?

使用步长语法:*/15 * * * *。分钟字段中的*/15表示「每隔15分钟」。同样,小时字段中的*/2表示「每2小时」。

cron中0和7都表示星期日吗?

在标准cron中,星期字段中的0和7都代表星期日。大多数cron实现都接受这两个值。星期一为1,星期二为2,以此类推,直至星期六(6)。

cron支持时区吗?

传统Unix cron使用服务器的系统时区。许多现代调度器(如带时区字段的Kubernetes CronJob、带时区属性的GitHub Actions)支持明确的时区设置。始终确认运行cron任务的服务器时区。

cron的最小频率是多少?

标准cron的最小分辨率为1分钟。对于亚分钟级调度,需要其他机制,如带睡眠间隔的连续循环,或支持秒级的任务调度器(如Java中的Quartz,或某些工具中的6字段cron)。