Cron 表达式与调度注意
可视化构建和验证 Cron 计划任务,并以通俗语言描述计划内容,生成可直接复制的表达式。
* * * * *every minute
Common presets
*****Cron format reference
│ ┌── hour (0–23)
│ │ ┌── day of month (1–31)
│ │ │ ┌── month (1–12)
│ │ │ │ ┌── day of week (0–6, Sun=0)
│ │ │ │ │
* * * * *
*Every value*/nEvery n-th valuea-bRange from a to ba,b,cSpecific values1-5Monday to Friday0 0 * * *Daily at midnightCron 表达式与调度注意
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
- Cron Syntax Explained: 20 Schedules You Can Copy, and the Traps to Avoid
The five cron fields, copy-ready schedules for common jobs, and the time-zone, DST and day-of-week traps across Linux, GitHub Actions and Kubernetes.
Related tools
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)。