Cron-Ausdruck lesen: 5 Felder und die Tag/Wochentag-Falle

Inhalt
- Die fünf Felder folgen immer derselben Reihenfolge
- Stern, Stern/N und Zahlen: Mehr brauchen Sie zum Lesen nicht
- Was passiert, wenn Sie den Ausdruck von Hand schreiben
- Die Falle, wenn Sie Tag und Wochentag zusammen angeben
- Bei anderer Zeitzone läuft der Job zu einer ganz anderen Zeit
- Zusammenfassung
- Häufig gestellte Fragen
Die fünf Felder folgen immer derselben Reihenfolge
Ein Cron-Ausdruck besteht aus fünf Feldern, die durch Leerzeichen getrennt sind. Die Reihenfolge lautet immer Minute – Stunde – Tag – Monat – Wochentag. Diese Reihenfolge gilt in jeder Crontab und in jedem CI-Scheduler gleichermaßen. Wenn Sie sie sich einmal eingeprägt haben, können Sie sie dauerhaft nutzen.
Feld
Bedeutung
Wertebereich
- Feld
Minute
0–59
- Feld
Stunde
0–23
- Feld
Tag (Day-of-Month)
1–31
- Feld
Monat
1–12
- Feld
Wochentag (Day-of-Week)
je nach Implementierung 0–6 oder 0–7
Der Zahlenbereich des Wochentagsfelds unterscheidet sich je nach Implementierung in Details. Häufig gelten sowohl 0 als auch 7 als Sonntag, doch das ist von Cron zu Cron leicht unterschiedlich. Statt sich die Zahlen zu merken, prüfen Sie den Wochentag daher besser anhand der Namen (Mo, Di, Mi usw.), die ein Werkzeug anzeigt.
Stern, Stern/N und Zahlen: Mehr brauchen Sie zum Lesen nicht
Die Zeichen in den einzelnen Feldern lassen sich grob in drei Arten einteilen.
- Stern (*) – steht für alle Werte, die an dieser Stelle möglich sind. Steht der Stern im Feld „Minute“, läuft der Job jede Minute. Steht er im Feld „Wochentag“, läuft er unabhängig vom Wochentag jeden Tag.
- Stern/N (*/N) – ein Schritt, der sich in Abständen von N wiederholt. Schreiben Sie im Minutenfeld */15, wird der Job jeweils zu den Minuten 0, 15, 30 und 45 ausgeführt.
- Bestimmte Zahl – der Job läuft nur, wenn genau dieser Wert erreicht ist. Eine 9 im Stundenfeld bedeutet: Ausführung nur um genau 9 Uhr.
Dazu kommt die Möglichkeit, mehrere Werte durch Kommas aufzulisten. Setzen Sie im Wochentagsfeld 1,3,5 ein, läuft der Job nur montags, mittwochs und freitags. Mit 3,6,9,12 im Monatsfeld läuft er nur im ersten Monat jedes Quartals. Mit diesen vier Kombinationen lässt sich auch ein Ausdruck wie „0 9 * * 1-5“ sofort lesen: „täglich um 9:00 Uhr, nur werktags“.
Was passiert, wenn Sie den Ausdruck von Hand schreiben
Selbst eine einfache Anforderung wie „werktags um 9 Uhr morgens ausführen“ bringt einen beim Schreiben von Hand leicht durcheinander. Man vertauscht Minute und Stunde, oder man muss jedes Mal in der Dokumentation nachschlagen, ob die Wochentagszahlen bei 0 oder bei 1 beginnen. Auch fehlt meist eine gute Möglichkeit zu prüfen, zu welchen Zeitpunkten ein Ausdruck tatsächlich ausgeführt wird. Deshalb trägt man ihn oft einfach in die Crontab ein und sieht erst am nächsten Tag im Log, ob er richtig oder falsch war.
Wählen Sie Minute, Stunde, Tag, Monat und Wochentag per Dropdown aus. Das Tool erstellt den Standard-Cron-Ausdruck mit fünf Feldern und eine verständliche Erklärung in einem Satz.

Wenn Sie die Felder nacheinander per Dropdown auswählen, erscheint zusammen mit dem Ausdruck sofort eine verständliche Erklärung in ganzen Sätzen. So können Sie vor dem Eintragen mit eigenen Augen prüfen, ob der gewünschte Zeitpunkt stimmt. Gängige Muster gibt es außerdem als Voreinstellungen, Sie müssen also nicht jedes Mal bei null anfangen.
Die Falle, wenn Sie Tag und Wochentag zusammen angeben
Am häufigsten wird in Cron missverstanden, was passiert, wenn man Tag (Day-of-Month) und Wochentag (Day-of-Week) gleichzeitig festlegt. Manche wollen „nur am 15. eines Monats, und zwar nur, wenn dieser Tag ein Montag ist“ und tragen deshalb im Tagesfeld 15 und im Wochentagsfeld 1 ein. Die meisten Cron-Implementierungen verknüpfen die beiden Felder jedoch nicht mit UND, sondern mit ODER.
Tatsächlich läuft der Job also, sobald eine der beiden Bedingungen zutrifft: „der 15. eines Monats“ oder „jeder Montag dieses Monats“. Auch in Monaten, in denen der 15. kein Montag ist, wird er am 15. auf jeden Fall ausgeführt, und zusätzlich läuft er an jedem Montag. Diese Regel gilt immer, sobald eines der beiden Felder kein Stern (*) ist. Wenn Sie Tag und Wochentag gleichzeitig einschränken und eine „Schnittmenge“ bilden möchten, lässt sich das mit der Cron-Syntax allein nicht ausdrücken.
Muss eine solche Bedingung wirklich gelten, umgeht man das üblicherweise so: Statt eine Bedingung im Scheduler zu setzen, prüft das ausgeführte Skript selbst das heutige Datum und den Wochentag und beendet sich, wenn die Bedingung nicht erfüllt ist.
Bei anderer Zeitzone läuft der Job zu einer ganz anderen Zeit
Ein Cron-Ausdruck selbst enthält keine Zeitzoneninformation. Er ist nur eine Kombination von Zahlen, und in welcher Zeitzone diese Zahlen interpretiert werden, hängt allein von der Konfiguration des Servers, des Schedulers oder des CI-Runners ab, auf dem Cron läuft. Ein Ausdruck für „täglich um 9 Uhr morgens“ läuft deshalb zu einer völlig anderen lokalen Uhrzeit, wenn die ausführende Instanz auf eine andere Zeitzone eingestellt ist.
Jeder Scheduler legt die Zeitzone anders fest, und auch die Standardwerte unterscheiden sich. Kommt es auf die genaue Ausführungszeit an, ist der einzig sichere Weg, vor dem Eintragen des Ausdrucks die Zeitzoneneinstellung des jeweiligen Schedulers selbst zu prüfen. Nehmen Sie besser nicht an, sie stimme mit Ihrer lokalen Uhr überein.
Zusammenfassung
- Ein Cron-Ausdruck hat fest fünf Felder in der Reihenfolge Minute – Stunde – Tag – Monat – Wochentag. Die Reihenfolge ändert sich in keiner Implementierung.
- Jedes Feld wird mit einem der folgenden Elemente gefüllt: Stern (*, alle Werte), Stern/N (Schritt), bestimmte Zahl oder Kommaliste (mehrere Werte).
- Geben Sie Tag und Wochentag gleichzeitig an, werden sie mit ODER statt mit UND verknüpft. Der Job kann dadurch häufiger laufen als beabsichtigt.
- Die Ausführungszeit richtet sich nach der Zeitzone des Servers bzw. Schedulers, auf dem Cron läuft. Prüfen Sie sie deshalb vor dem Eintragen.
- Der Zahlenbereich der Wochentage unterscheidet sich je nach Implementierung. Prüfen Sie daher besser anhand der Wochentagsnamen als anhand der Zahlen.
Wählen Sie Minute, Stunde, Tag, Monat und Wochentag per Dropdown aus. Das Tool erstellt den Standard-Cron-Ausdruck mit fünf Feldern und eine verständliche Erklärung in einem Satz.
Häufig gestellte Fragen
Ist der Wochentag 0 in einem Cron-Ausdruck Sonntag oder Montag?
Das hängt von der Implementierung ab. Häufig wird 0 als Sonntag behandelt, und auch 7 steht separat für Sonntag, doch das unterscheidet sich von Cron zu Cron leicht. Statt sich die Zahlen zu merken, prüfen Sie den Wochentag besser anhand der Namen, die das verwendete Werkzeug oder der Scheduler anzeigt.
Wie führe ich einen Job nur am 15. eines Monats aus, wenn dieser ein Montag ist?
Mit der Standard-Cron-Syntax allein lassen sich die Felder Tag (Day-of-Month) und Wochentag (Day-of-Week) nicht gleichzeitig so einschränken, dass eine Schnittmenge entsteht. Werden beide Felder angegeben, gilt ODER: Der Job läuft dann immer am 15. und zusätzlich an jedem Montag. Wird wirklich eine Schnittmenge benötigt, prüft man üblicherweise im ausgeführten Skript selbst das heutige Datum und den Wochentag und beendet das Skript, wenn die Bedingung nicht erfüllt ist.
Ich habe einen Cron-Ausdruck eingetragen, aber der Job läuft nicht zur erwarteten Zeit. Woran liegt das?
Prüfen Sie zuerst die Zeitzone. Ein Cron-Ausdruck selbst enthält keine Zeitzoneninformation und wird anhand der Zeitzone interpretiert, die bei der ausführenden Instanz (Server, Scheduler, CI-Runner) eingestellt ist. Sie kann daher von Ihrer lokalen Uhr abweichen. Kontrollieren Sie als Nächstes, ob Sie Tag und Wochentag gleichzeitig angegeben haben, und prüfen Sie, ob der Job durch die ungewollte ODER-Verknüpfung womöglich häufiger läuft als gedacht.
Was genau ist der Unterschied zwischen Stern (*) und Stern/N (Schritt)?
Der Stern (*) steht für alle möglichen Werte an dieser Stelle. Im Minutenfeld bedeutet das: Die Bedingung ist in jeder Minute erfüllt. Stern/N wählt daraus nur jeden N-ten Wert aus. Schreiben Sie im Minutenfeld /15, ist die Bedingung nur bei den Minuten 0, 15, 30 und 45 erfüllt. Stern/N legt also eine Bedingung für gleichmäßige Abstände über den gesamten Bereich, den der Stern () abdeckt.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen