Skip to main content

Quartz Cron Attribute

Die Quartz-Cron-Engine unterstützt eine Zeit-Deklaration mit 7 Attributen mit vielen möglichen Werten. Das Format ist für jeden Ausdruck gleich, auch wenn die Werte unterschiedlich sind – sie müssen als Sekunden, Minuten, Stunden, Tag, Monat, Tage der Woche, dann das Jahr aufgelistet werden. Ein Leerzeichen unterscheidet jedes Attribut vom anderen.

Dies sind die möglichen Werte für jedes Attribut: 0-59 für Sekunden und Minuten, 0-23 für Stunden, 1-31 für Tage, 1-12 für Monate, 1-7 für Wochentage und eine vierstellige Jahreszahl. Alternativ können auch 3-Buchstaben Werte für die Wochentage eingetragen werden (MON, TUE, WED, THU, FRI, SAT, SUN) und 3-Buchstaben Werte für die Monate (JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC).

Ein Stern (*) kennzeichnet alle Werte. Wenn also ein Stern im Minutenfeld steht, heißt das, dass der Report einmal pro Minute läuft. Sie können mit dem (Dash) Operator einen Werte-Umfang spezifizieren und Sie können mehrfache, individuelle Werte mit einem Komma spezifizieren. Wenn Sie einen Wert im Feld „Tag des Monats“ und „Tag der Woche“ aus einem Cron-Job herausnehmen wollen, können Sie das Fragezeichen verwenden, um anzuzeigen, dass dieser Wert irrelevant ist. Wenn Sie Werte aufteilen müssen, können Sie dies mit dem Schrägstrich (/) tun Dieser Operator bedeutet wörtlich „jeder“ – also würde */15 „jeder 15te“ bedeuten. Im Feld „Tag des Monats“ kann das Raute-Zeichen (#) benutzt werden, um einen bestimmten Tag des Monats zu kennzeichnen. Freitag des Monats wäre beispielsweise 6#2. Zu guter letzt kann man ein großes „L“ in den Feldern „Tag des Monats“ und „Tag der Woche“ einsetzen um „letzter“ anzuzeigen, wie in „letzter Tag der Woche. Ein großes „C“ in einem dieser Felder bedeutet „Kalender“ und kombiniert mit einer Zahl bedeutet es, dass der Report gemäß des geladenen Kalenders nach dem durch das „C“ ausgedrückten Intervall ausgeführt werden soll. Ein großes „W“ im Feld „Tag des Monats“ bedeutet „Wochentag“, was nur die Zeit von Montag bis Freitag umfasst. Die meisten dieser Werte können kombiniert werden, um jegliche Art von Cron-Jobs zu erstellen.

Attribute

Bedingungen und Operatoren

Sekunden

, - * /

Minuten

, - * /

Stunden

, - * /

Tag des Monats

, - * ? / L W C

Monat

, - * /

Tag der Woche

, - * ? / L C #

Jahr

, - * /

So sieht es aus, wenn Sie einen Report ausführen wollen – um 10:15 morgens, an jedem letzten Freitag jeden Monats während der Jahre 2008, 2009, 2010, 2011, 2012 und 2013.

0 15 10 ? * 6L 2008-2013

Weitere Details und Beispiele finden Sie hier:

http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html

Eine gute Seite, die Ihnen beim Schreiben und Testen der Quartz Cron Ausdrücke hilft, finden Sie hier:

https://www.freeformatter.com/cron-expression-generator-quartz.html#