Cron-Ausdrücke: Spickzettel mit echten Beispielen
Cron-Syntax auf einer Seite: fünf Felder, vier Operatoren, Zeitpläne zum Kopieren und die Fallstricke bei Wochentag-ODER, Sommerzeit und Varianten.
Aktualisiert
Ein Cron-Ausdruck besteht aus fünf durch Leerzeichen getrennten Feldern: Minute, Stunde, Tag des Monats, Monat, Wochentag. 0 9 * * 1-5 bedeutet 09:00 Uhr an jedem Werktag. * steht für jeden Wert, , zählt Werte auf, - gibt einen Bereich an, und / legt eine Schrittweite fest. Das ist der Großteil der Syntax; der Rest dieser Seite besteht aus Beispielen und den Fallstricken.
Die fünf Felder
Der Reihe nach, mit den erlaubten Wertebereichen:
- Minute:
0-59 - Stunde:
0-23(24-Stunden-Format) - Tag des Monats:
1-31 - Monat:
1-12oderJAN-DEC - Wochentag:
0-6, wobei0für Sonntag steht (7bedeutet auf den meisten Systemen ebenfalls Sonntag), oderSUN-SAT
Der Ausdruck löst aus, wenn die aktuelle Zeit zu allen Feldern passt, mit einer Ausnahme, die weiter unten behandelt wird. Die Zeiten werden in der Zeitzone der Maschine oder des Dienstes ausgewertet, auf dem der Scheduler läuft, und das ist auf Servern und in Containern meist UTC.
Operatoren
*jeder Wert.* * * * *heißt jede Minute.,Liste.0 9,17 * * *heißt 09:00 und 17:00 Uhr.-Bereich.0 9-17 * * *heißt zu jeder vollen Stunde von 09:00 bis einschließlich 17:00 Uhr, also neun Läufe./Schrittweite.*/15 * * * *heißt alle 15 Minuten::00,:15,:30,:45.0 */6 * * *heißt alle sechs Stunden. Schritte können mit einem Versatz beginnen:5/15im Minutenfeld bedeutet:05,:20,:35,:50.
Operatoren lassen sich kombinieren: 0 8-18/2 * * 1-5 heißt alle zwei Stunden von 08:00 bis 18:00 Uhr an Werktagen.
Echte Beispiele
* * * * *jede Minute*/5 * * * *alle 5 Minuten0 * * * *jede Stunde zur vollen Stunde30 * * * *jede Stunde um :300 0 * * *täglich um Mitternacht0 3 * * *täglich um 03:00 Uhr, der klassische Backup-Termin0 9 * * 1-5werktags um 09:00 Uhr0 0 * * 0wöchentlich, Sonntag um Mitternacht0 0 * * 1wöchentlich, Montag um Mitternacht0 0 1 * *am ersten Tag jedes Monats um Mitternacht0 0 1 1 *einmal im Jahr, am 1. Januar0 0 1 */3 *vierteljährlich: 1. Jan., 1. Apr., 1. Juli, 1. Okt.0 9,13,17 * * *dreimal täglich0 22 * * 1-5werktags abends um 22:00 Uhr0 0 * * 6,0Samstag und Sonntag um Mitternacht15 2 * * *täglich um 02:15 Uhr, versetzt zur vollen Stunde0 0 */2 * *ungefähr jeden zweiten Tag; die Schrittweite beginnt am 1. neu, ein Monat mit 31 Tagen endet also mit zwei Läufen direkt hintereinander
So einen Ausdruck von Hand zu schreiben ist leicht. Zu prüfen, ob er tut, was du gemeint hast, ist der Punkt, an dem der Cron-Ausdruck-Generator hilft: Er übersetzt jeden Ausdruck in einen verständlichen Satz und listet die nächsten fünf Ausführungszeiten auf.
Die Fallstricke
Tag des Monats und Wochentag sind ODER, nicht UND
Das ist die überraschendste Regel in cron. Sind beide Tagesfelder eingeschränkt, läuft der Job, sobald eines von beiden passt. 0 0 13 * 5 läuft am 13. jedes Monats und an jedem Freitag, nicht nur an Freitag, dem 13. Es gibt keine Standard-Cron-Syntax für „den 13. nur, wenn er ein Freitag ist“; diese Prüfung gehört ins Skript.
Letzter Tag des Monats
Standard-cron kennt kein L. 0 0 28-31 * * löst bis zu viermal aus. Der gängige Workaround ist, täglich zu laufen und das Skript prüfen zu lassen, ob date -d tomorrow +%d gleich 01 ist. Quartz (Java) und einige Cloud-Scheduler erweitern die Syntax um L, W und #, aber solche Ausdrücke laufen nicht in einer Linux-crontab.
Sommerzeit
Ein Job mit 0 2 * * * in einer Zeitzone mit Sommerzeit wird in der Nacht der Umstellung auf Sommerzeit übersprungen und in der Nacht der Rückstellung zweimal ausgeführt. Plane Server in UTC, oder wähle Stunden, die nie ins Umstellungsfenster fallen.
Varianten abseits des Standards
- Die Linux-crontab akzeptiert
@hourly,@daily,@weekly,@monthly,@yearlyund@reboot. - Quartz, Spring und einige AWS-Dienste verwenden sechs oder sieben Felder, mit Sekunden am Anfang und einem optionalen Jahr am Ende.
0 0 9 * * ?ist die Quartz-Schreibweise für täglich um 09:00 Uhr; das?bedeutet „kein bestimmter Wert“ und ist in einem der beiden Tagesfelder Pflicht. - GitHub Actions und Kubernetes CronJobs verwenden die fünf Standardfelder in UTC. GitHub dokumentiert außerdem, dass das kürzeste erlaubte Intervall fünf Minuten beträgt und dass Jobs zu Stoßzeiten verspätet starten können.
Cron hat kein Gedächtnis. Ist die Maschine aus oder läuft der Container in der geplanten Minute nicht, fällt dieser Lauf einfach aus. Nutze eine Job-Queue oder einen Scheduler mit Nachhol-Semantik, wenn jeder Lauf zählt.
Deinen Zeitplan prüfen
Die Liste der nächsten Läufe ist die schnellste Plausibilitätsprüfung. Wenn die ersten fünf Zeiten nicht dem entsprechen, was du dir vorgestellt hast, ist der Ausdruck falsch. Bei einem Job, der Zeitstempel in Logs oder eine Datenbank schreibt, wandelst du die aufgezeichneten Epoch-Werte mit dem Unix-Timestamp-Konverter um und vergleichst sie mit dem beabsichtigten Zeitplan; eine Abweichung von einer Stunde nach einer Zeitumstellung ist ein häufiger Fund.
Um zu messen, wie weit zwei Läufe tatsächlich auseinanderlagen, liefert der Zeitdauer-Rechner den genauen Abstand zwischen zwei Zeitstempeln in Tagen, Stunden und Minuten.
Weitere Helfer für Zeitpläne und Formatierung findest du in der Kategorie Entwickler.
Probier es aus
Tippe oder baue einen Ausdruck im Cron-Ausdruck-Generator, lies die Zusammenfassung und bestätige die nächsten fünf Ausführungszeiten, bevor er in einer crontab, einem CI-Workflow oder einem CronJob-Manifest landet.