Do czego służy
Parser wyrażeń cron objaśnia harmonogram cron prostym językiem i wypisuje najbliższe terminy jego uruchomień. Składnia cron jest zwięzła, ale łatwo o pomyłkę: czy 0 9 * * 1-5 to godzina dziewiąta w dni robocze, czy każda minuta między 9:00 a 9:59? Wklej tu wyrażenie przed wdrożeniem i sprawdź dokładnie, kiedy się wykona.
Każde z pięciu pól jest też rozpisane na dokładne wartości, które dopuszcza, dzięki czemu łatwo wychwycić błędy w zakresach i krokach.
Jak używać
- Wpisz wyrażenie cron w polu wejściowym lub kliknij Przykład.
- Przeczytaj opis i tabelę pól. Błędy wskazują pole i kolumnę, które są nieprawidłowe, na przykład godzinę 24.
- Wybierz czas Lokalny lub UTC dla najbliższych uruchomień oraz liczbę uruchomień do pokazania.
Składnia cron
Wyrażenie cron ma pięć pól oddzielonych spacjami:
┌───────────── minute (0–59)
│ ┌─────────── hour (0–23)
│ │ ┌───────── day of month (1–31)
│ │ │ ┌─────── month (1–12 or JAN–DEC)
│ │ │ │ ┌───── day of week (0–7 or SUN–SAT, 0 and 7 are Sunday)
│ │ │ │ │
* * * * *
| Symbol | Znaczenie | Przykład |
|---|---|---|
* | każda wartość | * w polu godziny = co godzinę |
, | lista | 1,15 = 1. i 15. dnia |
- | zakres | MON-FRI = od poniedziałku do piątku |
/ | krok | */15 = co 15 minut |
Akceptowane są też skróty: @hourly, @daily (lub @midnight), @weekly, @monthly i @yearly (lub @annually).
Przykłady
| Wyrażenie | Uruchamia się |
|---|---|
*/5 * * * * | co 5 minut |
0 * * * * | na początku każdej godziny |
0 9 * * 1-5 | o 09:00 w dni robocze |
30 2 1 * * | o 02:30 pierwszego dnia każdego miesiąca |
0 0 * * 0 | o północy w każdą niedzielę |
FAQ
› Jakiego formatu cron używa to narzędzie?
Standardowego pięciopolowego formatu cron z Uniksa (Vixie), używanego przez crontab, Kubernetes CronJobs, GitHub Actions i większość harmonogramów. Formaty sześciopolowe z sekundami (Quartz, Spring) nie są obsługiwane.
› Co się dzieje, gdy ustawione są zarówno dzień miesiąca, jak i dzień tygodnia?
Standardowy cron uruchamia zadanie, gdy pasuje którykolwiek z nich. Na przykład 0 0 1,15 * 5 uruchamia się 1. i 15. dnia każdego miesiąca oraz w każdy piątek.
› Dlaczego czasy uruchomień na moim serwerze są inne?
Cron używa strefy czasowej maszyny lub usługi, która go uruchamia. GitHub Actions i większość chmurowych harmonogramów używa UTC, więc przełącz Strefę czasową na UTC, aby zobaczyć, co faktycznie zrobią.
› Czy można używać nazw takich jak MON czy JAN?
Tak. Miesiące przyjmują JAN–DEC, a dni tygodnia SUN–SAT, niezależnie od wielkości liter. Niedzielę można zapisać jako 0 lub 7.