Cron-Ausdruck lesen: Die 5 Felder einfach erklärt

Inhalt
Wenn Cron-Ausdrücke verwirrend werden
In einer crontab-Datei auf dem Server oder in der Zeitplan-Konfiguration einer CI/CD-Pipeline steht oft ohne jede Erklärung nur eine Reihe aus fünf Zahlen und Zeichen wie ‚0 3 1,15 * 3‘. Wenn die Person, die den Ausdruck ursprünglich angelegt hat, nicht mehr da ist oder die Konfiguration von einem anderen Team übernommen wurde, kann niemand mehr sagen, an welchen Tagen diese eine Zeile genau ausgeführt wird.
Schwierig wird es vor allem, wenn sowohl das Feld für den Tag (Day-of-Month) als auch das Feld für den Wochentag (Day-of-Week) einen Wert enthält. ‚1,15‘ steht für den 1. und den 15. jedes Monats, ‚3‘ für Mittwoch.
Stehen beide zusammen, hängt die Anzahl der Ausführungen pro Monat davon ab, ob man sie einschränkend als „1. und zugleich Mittwoch“ oder erweiternd als „1. oder Mittwoch“ liest. Wer die Regeln für die Felder nicht genau kennt, kann das der Schreibweise allein nicht ansehen.
So lesen Sie einen Cron-Ausdruck ohne Hilfsmittel
Einen Cron-Ausdruck können Sie auch ohne Tool Schritt für Schritt von Hand auflösen.
Schritt 1 – Teilen Sie die fünf Felder nach Reihenfolge und Wertebereich auf. Die durch Leerzeichen getrennten Felder stehen immer in der Reihenfolge ‚Minute Stunde Tag Monat Wochentag‘, und jedes hat einen festen Wertebereich.
Feld
Position
Wertebereich
Minute
0–59
Stunde
0–23
Tag (Day-of-Month)
1–31
Monat
1–12 (JAN–DEC)
Wochentag (Day-of-Week)
0–7 (SUN–SAT, 0 und 7 stehen beide für Sonntag)
Hat der Ausdruck nicht genau fünf Felder (zum Beispiel ein Makro wie ‚@daily‘ oder eine Eingabe mit anderer Feldanzahl), handelt es sich nicht um die hier beschriebene Standardschreibweise mit fünf Feldern.
Schritt 2 – Zerlegen Sie jedes Feld an den Kommas und deuten Sie jeden Teil einzeln. Steht in einem Feld ein Komma (,), ist die Menge der passenden Werte die Vereinigungsmenge der Werte, die die einzelnen Teile beschreiben. Jeder Teil hat eine der folgenden vier Schreibweisen:
- '*' – der gesamte Wertebereich des Feldes
- 'a-b' – der Bereich von a bis b (beide Enden eingeschlossen)
- einzelne Zahl 'a' – genau dieser eine Wert
- 'a/n' oder '/n' – Werte ab einem Startwert im Abstand von n. '/n' beginnt beim Mindestwert des Feldes, 'a/n' bei a und läuft bis zum Höchstwert des Feldes.
Schritt 3 – Ersetzen Sie die englischen Abkürzungen für Monat und Wochentag durch Zahlen. Bei den Monaten gilt JAN=1 bis DEC=12, bei den Wochentagen SUN=0 bis SAT=6. Das Wochentagsfeld akzeptiert Zahlen von 0 bis 7, wobei 0 und 7 beide Sonntag bedeuten. Ob Sie Sonntag als 0 oder als 7 schreiben, ergibt denselben Tag.
Schritt 4 – Prüfen Sie, ob Tag und Wochentag gleichzeitig angegeben sind. Sind das Tagesfeld (Day-of-Month) und das Wochentagsfeld beide nicht '*', werden die beiden Felder nicht per UND (Schnittmenge), sondern per ODER (Vereinigungsmenge) ausgewertet.
Der Job läuft also, wenn der Tag einer der angegebenen Tage des Monats ist oder einer der angegebenen Wochentage. Ist dagegen eines der beiden Felder '*', entfällt es als Bedingung, und nur das andere Feld entscheidet.
Als Beispiel lösen wir ‚30 9 * * 1-5‘ der Reihe nach auf:
- Minute: 30 → Minute 30
- Stunde: 9 → 9 Uhr
- Tag: * → jeder Tag des Monats
- Monat: * → jeder Monat
- Wochentag: 1-5 → Montag bis Freitag
Da Tag und Monat '*' sind und nur der Wochentag einen Wert hat, läuft dieser Ausdruck jeden Montag bis Freitag um 9:30 Uhr.
Anders sieht es aus, wenn Tag und Wochentag beide einen Wert haben. Wir lösen ‚0 3 1,15 * 3‘ auf dieselbe Weise auf:
- Minute: 0, Stunde: 3 → 3:00 Uhr
- Tag: 1,15 → der 1. und der 15. jedes Monats
- Monat: * → jeder Monat
- Wochentag: 3 → Mittwoch
Da Tag (1, 15) und Wochentag (Mittwoch) beide nicht '*' sind, werden sie per ODER verknüpft. Der Ausdruck läuft also um 3:00 Uhr, wenn der Tag der 1. oder der 15. des Monats ist oder wenn der Tag ein Mittwoch ist. Er wird also nicht nur am 1. und 15., sondern zusätzlich an jedem Mittwoch des Monats ausgeführt.
Prüfen Sie den Ausdruck mit unserem Cron-Ausdruck-Generator.
Sobald Sie einen Ausdruck eingeben, wird er direkt im Browser Feld für Feld ausgewertet. Ihre Eingabe wird nicht an einen Server gesendet.

Häufige Missverständnisse bei der Cron-Schreibweise
Mit wenigen Regeln lassen sich die meisten Missverständnisse bei der Cron-Schreibweise aufklären. Besonders die folgenden fünf Punkte sorgen immer wieder für Verwirrung.
Missverständlicher Punkt
Tatsächliche Regel
Wochentag '0' und '7'
Beide bedeuten Sonntag. Es sind keine unterschiedlichen Wochentage.
Tag und Wochentag gleichzeitig angegeben
Sie werden per ODER (Vereinigungsmenge) verknüpft, nicht per UND (Schnittmenge). Es genügt, wenn eine der beiden Bedingungen zutrifft.
Wochentag '1-5'
Es gibt keine eigene Schreibweise für „Werktage“. Gemeint ist der Bereich von Montag (1) bis Freitag (5).
'*/15' und '5/15'
'*/15' beginnt bei 0 und springt im Abstand von 15 (0, 15, 30, 45). '5/15' beginnt bei 5 und springt im Abstand von 15 bis zum Höchstwert des Feldes (5, 20, 35, 50). Der Startpunkt ist unterschiedlich.
Makros wie '@daily'
Sie sind keine Schreibweise mit den fünf Feldern Minute, Stunde, Tag, Monat und Wochentag und werden deshalb anders behandelt als das Standardformat mit fünf Feldern.
Liegt ein Feldwert außerhalb des zulässigen Bereichs (zum Beispiel 60 im Minutenfeld) oder hat der Ausdruck nicht genau fünf Felder, wird er nicht als gültiger Ausdruck interpretiert.
Zusammenfassung
Beim Lesen eines Cron-Ausdrucks lassen sich fünf Dinge festhalten:
- Es sind immer fünf Felder in der Reihenfolge ‚Minute Stunde Tag Monat Wochentag‘.
- '*', Bereiche (a-b), Listen (a,b) und Intervalle (a/n, */n) werden jeweils nach festen Regeln zu einer Wertemenge aufgelöst, und die durch Kommas getrennten Teile werden zur Vereinigungsmenge zusammengefasst.
- Das Wochentagsfeld hat den Wertebereich 0–7, wobei 0 und 7 beide Sonntag bedeuten.
- Werden Tag und Wochentag gleichzeitig angegeben, gilt ODER, nicht UND.
- Die Regeln lassen sich auch von Hand anwenden. Überschneiden sich jedoch mehrere Felder, geht es mit einer tabellarischen Aufstellung schneller und zuverlässiger.
Sobald Sie einen Ausdruck eingeben, wird er direkt im Browser Feld für Feld ausgewertet. Ihre Eingabe wird nicht an einen Server gesendet.
Häufig gestellte Fragen
Darf ich beim Wochentag sowohl 0 als auch 7 verwenden?
Ja. Das Wochentagsfeld akzeptiert Werte von 0 bis 7, und sowohl 0 als auch 7 gelten als Sonntag. 6 ist Samstag, 1 bis 5 stehen der Reihe nach für Montag bis Freitag.
Müssen beim gleichzeitigen Angeben von Tag und Wochentag beide Bedingungen erfüllt sein?
Nein. Sind das Tagesfeld (Day-of-Month) und das Wochentagsfeld beide mit einem anderen Wert als '*' belegt, werden sie per ODER (Vereinigungsmenge) ausgewertet. Geben Sie zum Beispiel beim Tag '1,15' und beim Wochentag '3' (Mittwoch) an, läuft der Job nicht nur am 1. und 15. jedes Monats, sondern zusätzlich an jedem Mittwoch des Monats.
Ist dagegen eines der beiden Felder '*', entfällt es als Bedingung, und nur das andere Feld gilt.
Bedeuten '*/15' und '5/15' dasselbe?
Nein. '*/15' beginnt beim Mindestwert des Feldes (bei Minuten also 0) und springt im Abstand von 15, ergibt also 0, 15, 30, 45. '5/15' hat die Form 'a/n': Es beginnt bei 5 und springt im Abstand von 15 bis zum Höchstwert des Feldes, ergibt also 5, 20, 35, 50. Weil der Startwert verschieden ist, unterscheidet sich auch die resultierende Wertemenge.
Wird der eingegebene Ausdruck an einen Server gesendet?
Nein. Die Auswertung des Ausdrucks erfolgt vollständig im Browser. Ihre Eingabe wird weder an einen Server gesendet noch gespeichert.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen