Cron-Ausdruck-Parser

Einen Cron-Ausdruck lesen

Ein Cron-Ausdruck besteht aus fünf durch Leerzeichen getrennten Feldern, von links gelesen: Minute, Stunde, Tag des Monats, Monat, Wochentag. Fast jeder Cron-Fehler ist entweder ein Feld an falscher Position oder ein Missverständnis darüber, wie die beiden Tagesfelder zusammenwirken.

So wird gerechnet

• Zerlegt die fünf Felder, beschreibt jedes in Worten und listet die nächsten Ausführungszeitpunkte.
• Beherrscht die Standardoperatoren: * für jeden Wert, */n für jeden n-ten, a-b für Bereiche und a,b,c für Listen.
• Interpretiert den Ausdruck in der Zeitzone Ihres Browsers — nicht zwingend der Ihres Servers.

┌───────── Minute        (0–59)
│ ┌─────── Stunde        (0–23)
│ │ ┌───── Tag im Monat  (1–31)
│ │ │ ┌─── Monat         (1–12)
│ │ │ │ ┌─ Wochentag     (0–6, Sonntag = 0)
│ │ │ │ │
* * * * *

Rechenbeispiel

Entschlüsselung von 30 2 * * 1-5 — ein Zeitplan, an dem sich viele wegen der beiden Tagesfelder stoßen.

1. Minute = 30
2. Stunde = 2
3. Tag im Monat = * (jeder Tag)
4. Monat = * (jeder Monat)
5. Wochentag = 1-5 (Montag bis Freitag)

Läuft werktags um 02:30. Beachten Sie, dass der Tag im Monat hier * ist — stünde dort eine konkrete Zahl, liefe Cron, sobald eines der beiden Tagesfelder passt, nicht beide. Das ist die häufigste Cron-Überraschung.

Das Ergebnis lesen

• Sind Tag im Monat und Wochentag beide eingeschränkt, verknüpft Cron mit ODER, nicht mit UND. 0 0 1 * 1 läuft am 1. des Monats UND an jedem Montag, nicht nur an Montagen, die auf den 1. fallen.
• Cron nutzt die Serverzeitzone, sofern nicht anders konfiguriert, und die meisten Crontabs gehen mit der Zeitumstellung schlecht um. Ein Job um 02:30 kann in der Umstellungsnacht doppelt oder gar nicht laufen.
• Ein „alle 90 Minuten“ gibt es nicht. Schrittwerte teilen das Feld, daher ist */90 im Minutenfeld ungültig; formulieren Sie es als zwei Einträge oder verlagern Sie die Intervalllogik in den Job.
• Manche Implementierungen stellen ein sechstes Sekundenfeld voran, Quartz nutzt sieben inklusive Jahr. Prüfen Sie den Dialekt Ihres Schedulers, bevor Sie einen Ausdruck von anderswo kopieren.

Häufige Fragen

Warum läuft mein Job häufiger als erwartet?

Meist wegen der ODER-Verknüpfung von Tag im Monat und Wochentag oder wegen eines Schrittwerts im falschen Feld. Den Ausdruck in Worten zurückzulesen, wie dieses Werkzeug es tut, deckt beides schnell auf.

Wie plane ich etwas auf den letzten Tag des Monats?

Standard-Cron kann das nicht ausdrücken. Üblich ist, täglich zu laufen und den Job sofort zu beenden, sofern morgen nicht der 1. ist. Einige Dialekte bieten dafür ein L.

Quellen

• POSIX.1-2017 — crontab