Home › Convert › Spring to GitHub Actions
Convert Spring cron to GitHub Actions
Spring expressions look similar to GitHub Actions, but the differences matter. Paste yours below; the result is checked against the original run times.
What changes from Spring to GitHub Actions
- GitHub Actions has no seconds field, so a schedule that fires on specific seconds cannot be converted exactly. The seconds value is dropped and flagged.
- Spring requires both day fields to match; GitHub Actions fires when either does. Schedules that restrict both are flagged.
- GitHub Actions has no
L,Wor#symbols. Schedules like "last day of the month" cannot be converted and are refused rather than silently changed.
Worked examples
| Schedule | Spring | GitHub Actions |
|---|---|---|
| every minute | 0 * * * * * | * * * * * |
| every 5 minutes | 0 */5 * * * * | */5 * * * * |
| every 10 minutes | 0 */10 * * * * | */10 * * * * |
| every 15 minutes | 0 */15 * * * * | */15 * * * * |
| every 30 minutes | 0 */30 * * * * | */30 * * * * |
| every hour | 0 0 * * * * | 0 * * * * |
| every 2 hours | 0 0 */2 * * * | 0 */2 * * * |
| every 3 hours | 0 0 */3 * * * | 0 */3 * * * |
Conversions that come with a warning
- every 10 seconds:
*/10 * * * * *→* * * * *. GitHub Actions has no seconds field; the seconds value "*/10" was dropped. - every 30 seconds:
*/30 * * * * *→* * * * *. GitHub Actions has no seconds field; the seconds value "*/30" was dropped.
What cannot be converted
These common Spring schedules have no equivalent in GitHub Actions. The converter refuses them instead of guessing.
- on the last day of every month:
0 0 0 L * *. This schedule cannot be expressed in GitHub Actions: "L" is not a valid dom value. - on the first Monday of every month at 9:00 AM:
0 0 9 * * MON#1. This schedule cannot be expressed in GitHub Actions: "MON#1" is not a valid dow value. - on the last Friday of every month at noon:
0 0 12 * * 5L. This schedule cannot be expressed in GitHub Actions: "5L" is not a valid dow value.
Field layout and time zones
second (0-59), minute (0-59), hour (0-23), day-of-month (1-31), month (1-12), day-of-week (0-7, 0 and 7 = Sunday).
Spring evaluates in the server time zone by default. Add zone = "UTC" (or any ZoneId) to @Scheduled to make it explicit.
minute (0-59), hour (0-23), day-of-month (1-31), month (1-12), day-of-week (0-6, 0 = Sunday).
GitHub Actions schedules are always UTC. Convert your local time to UTC before writing the expression.
Go the other way
Convert GitHub Actions to Spring, or open the Spring builder or the GitHub Actions builder.
Frequently asked questions
How do I convert a Spring cron expression to GitHub Actions?
Paste it into the converter above with Spring as the source and GitHub Actions as the target. For example, 0 * * * * * becomes * * * * *.
Is every Spring expression convertible to GitHub Actions?
No. Out of 32 common schedules, 3 cannot be expressed in GitHub Actions: on the last day of every month; on the first Monday of every month at 9:00 AM; on the last Friday of every month at noon.
Does GitHub Actions run in the same time zone as Spring?
Not necessarily. Conversion changes the syntax, not the time zone. Check where each system evaluates the schedule before you rely on the same clock times.