GameParticles
Entwickler

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:

  1. Minute: 0-59
  2. Stunde: 0-23 (24-Stunden-Format)
  3. Tag des Monats: 1-31
  4. Monat: 1-12 oder JAN-DEC
  5. Wochentag: 0-6, wobei 0 für Sonntag steht (7 bedeutet auf den meisten Systemen ebenfalls Sonntag), oder SUN-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/15 im 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 Minuten
  • 0 * * * * jede Stunde zur vollen Stunde
  • 30 * * * * jede Stunde um :30
  • 0 0 * * * täglich um Mitternacht
  • 0 3 * * * täglich um 03:00 Uhr, der klassische Backup-Termin
  • 0 9 * * 1-5 werktags um 09:00 Uhr
  • 0 0 * * 0 wöchentlich, Sonntag um Mitternacht
  • 0 0 * * 1 wöchentlich, Montag um Mitternacht
  • 0 0 1 * * am ersten Tag jedes Monats um Mitternacht
  • 0 0 1 1 * einmal im Jahr, am 1. Januar
  • 0 0 1 */3 * vierteljährlich: 1. Jan., 1. Apr., 1. Juli, 1. Okt.
  • 0 9,13,17 * * * dreimal täglich
  • 0 22 * * 1-5 werktags abends um 22:00 Uhr
  • 0 0 * * 6,0 Samstag und Sonntag um Mitternacht
  • 15 2 * * * täglich um 02:15 Uhr, versetzt zur vollen Stunde
  • 0 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, @yearly und @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.

Tools in diesem Ratgeber

Häufige Fragen

Was bedeutet 0 0 * * * in cron?

Minute 0 der Stunde 0 an jedem Tag, in jedem Monat, an jedem Wochentag: mit anderen Worten täglich um Mitternacht in der Zeitzone des Schedulers.

Wie lasse ich einen Cronjob alle 5 Minuten laufen?

Verwende */5 im Minutenfeld: */5 * * * *. Der Schrittoperator beginnt bei 0, der Job läuft also um :00, :05, :10 und so weiter.

Warum läuft mein Cronjob an zusätzlichen Tagen, wenn ich beide Tagesfelder setze?

In Standard-cron werden Tag des Monats und Wochentag mit ODER verknüpft, nicht mit UND. 0 0 13 * 5 läuft am 13. jedes Monats und zusätzlich an jedem Freitag.

Welche Zeitzone verwendet cron?

Die Zeitzone des Hosts oder Dienstes, auf dem der Scheduler läuft. Server, Container, GitHub Actions und Kubernetes CronJobs nutzen standardmäßig UTC, sofern nichts anderes konfiguriert ist.

Weitere Entwickler-Ratgeber

JSON Formatter
Entwickler · Formatiere, validiere und minifiziere JSON mit Syntaxhervorhebung.
↵
Base64 kodieren / dekodieren
Entwickler · Kodiere Text in Base64 oder dekodiere Base64 zurück in Klartext.
↵
URL-Encoder / -Decoder
Entwickler · Kodiere oder dekodiere URL-Bestandteile und Query-Strings.
↵
Hash-Generator
Entwickler · Generiere MD5-, SHA-1-, SHA-256- und SHA-512-Hashes.
↵
UUID-Generator
Entwickler · Generiere UUIDs v4 (zufällig) massenweise mit einem Klick.
↵
Regex-Tester
Entwickler · Teste reguläre Ausdrücke an Text mit Live-Hervorhebung der Treffer.
↵
Wörter zählen
Text · Zähle Wörter, Zeichen, Sätze, Absätze und die Lesezeit.
↵
Groß-/Kleinschreibung umwandeln
Text · Wandle Text in GROSS, klein, Titel, camelCase, snake_case und mehr um.
↵
Listen-Sortierer
Text · Sortiere, kehre um, mische und bereinige Textlisten von Duplikaten.
↵
Markdown-Vorschau
Text · Schreibe Markdown und sieh die gerenderte Live-Vorschau direkt daneben.
↵
Prozentrechner
Zahlen · Berechne Prozentwerte, Zu- und Abnahmen und den Prozentanteil einer Zahl.
↵
Farbkonverter
Farben · Rechne Farben sofort zwischen HEX, RGB, HSL und HSV um.
↵
Snake
Arcade · Friss, wachse und meide die Wände. Ein zeitloser Klassiker.
↵
2048
Rätsel · Schiebe Kacheln und verbinde sie bis zur legendären 2048.
↵
Word Grid
Rätsel · Errate das versteckte Wort mit fünf Buchstaben in sechs Versuchen dank Farbhinweisen.
↵
Sudoku
Rätsel · Fülle das 9x9-Gitter mit Logik. Vier Stufen von leicht bis Experte.
↵
Minesweeper
Strategie · Räume das Minenfeld mit Zahlenhinweisen. Klassische Logik, drei Stufen.
↵
Breakout
Arcade · Zerschlage alle Steine mit Schläger und Ball. Power-ups, Combos, endlose Level.
↵
Tipptraining
Casual · Steigere WPM und Genauigkeit mit Übungen von 30 Sekunden bis 5 Minuten. Finde deine Schwachstellen.
↵
TypeRunner
Arcade · Tipp-Rennen im Mehrspielermodus. Fordere Freunde per Link heraus, schlage Computerläufer oder jage deinen Geist.
↵
Typing Blocks
Arcade · Tippe jedes Wort, bevor sein Holzblock landet. Liegst du daneben, wächst der Stapel zur Linie.
↵
Bubble Shooter
Arcade · Ziele, spiele über die Wände und lass Gruppen aus drei oder mehr Blasen platzen.
↵
Road Rush
Arcade · Fahre gegen sieben Rivalen durch den Verkehr und schlag dich an die Spitze.
↵