Convert cron to GitHub Actions
This page shows how to write a standard five-field Unix cron schedule as a GitHub Actions schedule. Every example below is produced by the CronLabs engine. To convert an expression of your own, open the interactive converter.
Example conversions
Each row shows a common cron expression, what it does, and the equivalent GitHub Actions schedule.
| Cron | Meaning | GitHub Actions |
|---|---|---|
| 0 9 * * * | at 9:00 AM | 0 9 * * * |
| */15 * * * * | every 15 minutes | */15 * * * * |
| 0 9 * * 1-5 | at 9:00 AM on weekdays | 0 9 * * 1-5 |
| 0 0 * * 0 | Every Sunday at midnight | 0 0 * * 0 |
| 0 0 1 * * | First day of every month at midnight | 0 0 1 * * |
| 30 2 * * * | at minute 30 at 2:30 AM | 30 2 * * * |
Ready-to-use GitHub Actions configuration
The snippet below schedules a job for at 9:00 AM on weekdays (cron 0 9 * * 1-5). Replace the placeholder command and names with your own values.
GitHub Actions · yaml
name: my-job
on:
schedule:
- cron: "0 9 * * 1-5"
jobs:
run:
runs-on: ubuntu-latest
steps:
- run: /path/to/jobThings to know about GitHub Actions schedules
Scheduled workflows always run in UTC and can be delayed during periods of high load.
GitHub Actions runs scheduled jobs at most every 5 minutes; finer intervals are coalesced.
For the full syntax, see the official GitHub Actions documentation.
Convert your own expression
Paste any cron expression into the validator to see its next run times, a calendar view, and the equivalent schedule for every supported platform.
Open the validator