0 0 1 * *
At 00:00 on day 1 of the month
Field by Field
| Field | Value | Matches |
|---|---|---|
| Minute | 0 | 0 |
| Hour | 0 | 0 |
| Day of month | 1 | 1 |
| Month | * | every month |
| Day of week | * | every day |
The Last Day of the Month
Cron cannot express "the last day of the month". 0 0 31 * * runs in only seven months of
the year, silently skipping the rest — and 0 0 30 * * skips February.
The reliable pattern is to run on the 1st and look backwards:
``bash
# Monthly close for the *previous* month, run on the 1st
0 2 1 * * /usr/local/bin/close-month --for "$(date -d 'last month' +\%Y-\%m)"
`
Or run daily and exit unless tomorrow is the 1st:
`bash
0 23 28-31 * * [ "$(date -d tomorrow +\%d)" = "01" ] && /run/month-end.sh
`
| Expression | Runs |
|---|---|
0 0 1 * * | First of every month |
0 0 15 * * | Fifteenth of every month |
0 0 1 */3 * | Quarterly |
0 0 1 1 * | Once a year |
Time Zones
Standard crontab evaluates in system local time. Vercel Cron, GitHub Actions, Kubernetes
CronJobs and AWS EventBridge all evaluate in UTC. If converting your local time crosses
midnight, the day-of-week field shifts too — weekdays at 5pm in UTC-07:00 is
0 0 * * 2-6, not 0 0 * * 1-5.
The Day-Field Trap
When both the day-of-month and day-of-week fields are restricted, cron matches either,
not both. 0 0 13 * 5 runs on every 13th *and* every Friday — not Friday the 13th. Leave
one of them as * unless you genuinely want the union.
Other Common Schedules
| Expression | Runs |
|---|---|
* * * * * | Every minute |
*/5 * * * * | Every 5 minutes |
*/15 * * * * | Every 15 minutes |
0 * * * * | Every hour, on the hour |
0 0 * * * | Every day at midnight |
0 9 * * * | Every day at 9am |
0 9 * * 1-5 | Weekdays at 9am |
0 9 * * 1 | Every Monday at 9am |
Making the Job Safe
Assume double firing. DST transitions, restarts and retries all cause it. Make the job
idempotent rather than assuming exactly-once.
- Assume overlap. Cron starts the next run whether or not the last one finished. Take a
lock.
Avoid:00.Every hourly job on the internet fires at the top of the hour; a random
minute spreads load on shared APIs.
- Log the start and end. A cron job that silently stops running is invisible until
someone notices the missing output.Deploying This Schedule
`bash
# crontab -e (system local time)
0 0 1 * * /usr/local/bin/job.sh >> /var/log/job.log 2>&1
`
`json
// vercel.json (UTC)
{ "crons": [{ "path": "/api/job", "schedule": "0 0 1 * *" }] }
`
`yaml
# .github/workflows/job.yml (UTC)
on:
schedule:
- cron: '0 0 1 * *'
`
Starting from midnight UTC on 1 January 2026, this fires at:
| Next runs |
|---|
| 2026-02-01 00:00 UTC |
| 2026-03-01 00:00 UTC |
| 2026-04-01 00:00 UTC |
| 2026-05-01 00:00 UTC |
At 00:00 on day 1 of the month.Making It Survive Production
Redirect output. A cron job with no redirect emails its output to the crontab owner,
and on most servers that mail goes nowhere. Log to a file instead.
Use absolute paths. Cron runs with a minimal environment — noPATHyou recognise,
no shell profile, no nvm. A script that works in your terminal frequently fails here
for exactly that reason.
Escape percent signs. In a crontab,%means newline.date +\%Yneeds the
backslash or the command truncates at the percent.
Take a lock. Cron starts the next run whether or not the last finished.flock` is
- Alert on absence. A job that stops running is silent. Ping a dead-man's-switch service