Analizator Cron

Jak czytać wyrażenie cron

Wyrażenie cron to pięć pól rozdzielonych spacjami, czytanych od lewej: minuta, godzina, dzień miesiąca, miesiąc, dzień tygodnia. Niemal każdy błąd w cronie to albo pole na złej pozycji, albo niezrozumienie, jak współdziałają dwa pola dni.

Jak to działa

• Rozkłada pięć pól, opisuje każde słowami i wypisuje najbliższe terminy uruchomienia.
• Obsługuje standardowe operatory: * dla każdej wartości, */n co n-tą, a-b dla zakresów oraz a,b,c dla list.
• Interpretuje wyrażenie w strefie czasowej Twojej przeglądarki, która niekoniecznie jest tą, której używa serwer.

┌───────── minuta         (0–59)
│ ┌─────── godzina        (0–23)
│ │ ┌───── dzień miesiąca  (1–31)
│ │ │ ┌─── miesiąc         (1–12)
│ │ │ │ ┌─ dzień tygodnia  (0–6, niedziela = 0)
│ │ │ │ │
* * * * *

Przykład z liczbami

Odczyt 30 2 * * 1-5 — harmonogramu, na którym ludzie się potykają przez dwa pola dni.

1. minuta = 30
2. godzina = 2
3. dzień miesiąca = * (każdy dzień)
4. miesiąc = * (każdy miesiąc)
5. dzień tygodnia = 1-5 (od poniedziałku do piątku)

Uruchamia się o 02:30 w każdy dzień roboczy. Zwróć uwagę, że dzień miesiąca to tutaj * — gdyby była tam konkretna liczba, cron zadziałałby, gdy zgodzi się którekolwiek z pól dni, a nie oba. To najczęstsza niespodzianka w cronie.

Jak czytać wynik

• Gdy ograniczone są jednocześnie dzień miesiąca i dzień tygodnia, cron stosuje LUB, a nie ORAZ. 0 0 1 * 1 uruchomi się pierwszego dnia miesiąca ORAZ w każdy poniedziałek, a nie tylko w poniedziałki wypadające pierwszego.
• Cron używa strefy serwera, o ile nie skonfigurowano inaczej, a większość crontabów źle radzi sobie ze zmianą czasu. Zadanie na 02:30 może w noc zmiany zegara wykonać się dwa razy albo wcale.
• Nie ma czegoś takiego jak „co 90 minut”. Krok dzieli pole, więc */90 w polu minut jest niepoprawne; zapisz to jako dwa wpisy albo przenieś logikę interwału do samego zadania.
• Część implementacji dokłada z przodu szóste pole sekund, a Quartz używa siedmiu, z rokiem. Zanim skopiujesz wyrażenie skądinąd, sprawdź, jakim dialektem mówi Twój planista.

Częste pytania

Dlaczego moje zadanie uruchamia się częściej, niż się spodziewam?

Zwykle przez zachowanie LUB między dniem miesiąca a dniem tygodnia albo przez krok zastosowany do złego pola. Odczytanie wyrażenia z powrotem słowami, tak jak robi to narzędzie, szybko wychwytuje jedno i drugie.

Jak zaplanować coś na ostatni dzień miesiąca?

Standardowy cron tego nie wyrazi. Typowy sposób to uruchamiać codziennie, a w zadaniu natychmiast kończyć działanie, jeśli jutro nie jest pierwszy. Niektóre dialekty dodają do tego znak L.

Źródła

• POSIX.1-2017 — crontab