1.4.2
🛠️ API Services
Cron Optionen

Cron Optionen

Alle zeitgesteuerten Dienste weisen den Parameter cronOptions auf. Dieser dient zum Festlegen des Intervals, in dem der Dienst ausgeführt werden soll.

Bei den Parametern kann eine Vielzahl unterschiedlicher Ausdrücke angegeben werden, und bei der Bestimmung der nächsten Ausführungszeit wird die frühestmögliche Zeit gefunden, die die Bedingungen in allen Feldern erfüllt. Dieses Verhalten ähnelt dem „Cron“-Dienstprogramm, das in den meisten UNIX-ähnlichen Betriebssystemen zu finden ist.

Parameter

EigenschaftTypBeschreibung
yearintJahr (4-stellig)
monthintMonat 1-12
dayintTag im Monat 1-31
weekintISO Woche 1-53
day_of_weekintTag in der Woche 0-6
hourintStunde 0-23
minuteintMinute 0-59
secondintSekunde 0-59
start_dateStringStartzeit im Format ISO 8601 (opens in a new tab)
end_dateStringEndzeit im Format ISO 8601 (opens in a new tab)
timezoneStringZeitzone z.B. Europe/Berlin

Ausdrücke

Die folgende Tabelle listet alle verfügbaren Ausdrücke auf, die in den Feldern von year bis second verwendet werden können. Mehrere Ausdrücke können in einem einzigen Feld angegeben und durch Kommas getrennt werden.

AusdruckEigenschaftBeschreibung
\*alleAuslösung bei jedem Wert
\*/aalleAuslösung alle a Werte, beginnend mit dem Minimum
a-balleAuslösung bei jedem Wert im Bereich von a bis b (a muss kleiner als b sein)
a-b/calleAuslösung alle c Werte innerhalb des Bereichs a bis b
xth ydayAuslösung am x-ten Auftreten des Wochentags y innerhalb des Monats
last xdayAuslösung am letzten Auftreten des Wochentags x innerhalb des Monats
lastdayAuslösung am letzten Tag des Monats
x,y,zbeliebigAuslösung bei jedem passenden Ausdruck; kann eine beliebige Anzahl der oben genannten Ausdrücke kombinieren

Beispielkonfiguration

{
  "cronOptions": {
    "day_of_week": 0,
    "hour": 04,
    "minute": "*/15",
    "timezone": "Europe/Berlin"
  }
}

Beispielinterval für jeden Montag 4 Uhr alle 15 Minuten, also 04:00, 04:15, 04:30 und 04:45 Uhr