Skip to main content

Cron-Planungs-Syntaxreferenz

In diesem Abschnitt wird die Syntax zum Definieren geplanter Ausführungen mit Cron in Alteryx Analytics Cloud (AAC) beschrieben. In der Regel wird diese Methode für wiederholte Zeitpläne verwendet.

Anmerkung

Zeitzoneneinstellungen, die auf der Seite AAC definiert sind, auf der Sie den Cron-Zeitplan angeben, werden mit dem Zeitplan verwendet. Um die UTC-Zeitzone zu verwenden, wählen Sie UTC in der Dropdown-Liste aus.

Überblick über Cron

AAC ermöglicht die Verwendung von Cron, einer weit verbreiteten Syntax, zur Angabe von Zeiten, die in regelmäßigen Abständen wiederholt werden. Sie können Cron einsetzen, um Zeitpläne pro Minute oder pro Jahr und für beliebige Intervalle dazwischen anzugeben.

Cron-Syntax

Ein geplanter Cron ist als durch Leerzeichen getrennte Zeichenfolge von Werten definiert. Das folgende Cron-Beispiel definiert einen Zeitplan, der am 1. Februar um 23:30:00 Uhr ausgelöst wird:

Minute

Stunde

Tag des Monats

Monat

Wochentag

30

23

1

2

*

Wenn alle Werte zutreffen, wird der Cron-Auftrag ausgelöst.

Anmerkung

Die Angabe von Sekunden wird nicht unterstützt.

Platzhalter:

Im obigen Cron-Ausdruck kann der Platzhalter „*“ für jeden akzeptierten Wert verwendet werden. Dies bedeutet, dass der Cron-Wertetyp kein Faktor bei der Festlegung dieses Zeitplans ist. Da der Platzhalter auf den Wert „Wochentag“ angewendet wird, kann der Zeitplan an jedem Wochentag ausgelöst werden.

Anmerkung

Sie müssen das Zeichen * entweder im Feld „Wochentag“ oder im Feld „Tag des Monats“ verwenden. Die Angabe beider Felder im selben Cron-Ausdruck wird nicht unterstützt.

Legende:

Mit Ausnahme des letzten Feldes (Jahr) sind alle Felder im Cron-Ausdruck Pflichtfelder. Sonderzeichen werden unten in der Tabelle beschrieben.

Wert

Typ

Beschreibung

Unterstützte Sonderzeichen

30

Minute

0-59

, - * /

23

Stunde

0-23

, - * /

1

Tag des Monats

1-31

, - * / L W

2

Monat

1-12

, - * /

*

Wochentag

0–6 oder So–Sa

0, So, SO = Sonntag

1, Mo, MO = Montag

...

6, Sa, SA = Samstag

, - * / L #

*

Jahr

(Optional) Sie können bei Bedarf Einstellungen für das Jahr festlegen. Der Standardwert ist „*“.

, - * /

Sonderzeichen

Sie können die folgenden Sonderzeichen in Ihren Cron-Ausdrücken verwenden.

Zeichen

Beschreibung

*

( „Alle Werte“ ) – Platzhalter für alle möglichen Werte im Feld. Wenn Sie beispielsweise möchten, dass das Auslösen in jeder Minute der Stunde nach 22:00 Uhr stattfindet, ist das Minutenzeichen im Ausdruck * . Ein entsprechendes Beispiel finden Sie unten.

-

Geben Sie einen Wertebereich an. Beispiel: Sie können 1-5 im Feld „Wochentag“ verwenden, um die Arbeitstage der Woche (Montag bis Freitag) anzugeben. Ein entsprechendes Beispiel finden Sie unten.

,

Geben Sie eine Reihe von einzelnen Werten an. Beispiel: Ein Eintrag von 1,10,20,30 für das Feld „Tag des Monats“ wird am 1., 10., 20. und 30. (wenn möglich) des Monats ausgelöst.

/

Geben Sie Inkremente des Feldes in den Einheiten des Feldes an. Beispiel: 5/20 im Minutenfeld entspricht der 5., 25. und 45. Minute jeder Stunde.

L

Der letzte akzeptierte Wert im Bereich kann in den folgenden Feldern verwendet werden:

  • Tag des Monats: Gibt den letzten Tag des Monats für den aktuell ausgewählten Monatswert an.

    • Im Januar entspricht dieser Wert 31 .

    • Im Februar entspricht dieser Wert in Nicht-Schaltjahren 28 .

    • Im April entspricht dieser Wert 30 .

  • Wochentag:

    • Allein gibt er den letzten Wochentag an, der 6 (Samstag) entspricht.

    • Bei Verwendung mit einem anderen Wert wird der letzte entsprechende Wert für den Monat angegeben. Beispiel: 3L ist der letzte Mittwoch des Monats.

W

Gibt den nächstgelegenen entsprechenden Werktag an. Beispiel: Ein Eintrag von 22W im Feld „Tag des Monats“ entspricht dem Werktag, der dem 22. des Monats am nächsten ist. Wenn der 22. ein Samstag ist, wird der Cron-Auftrag am 24. (am folgenden Montag) ausgelöst.

Tipp

LW kann im Feld „Tag des Monats“ verwendet werden, um den letzten Werktag des Monats anzugeben.

#

Gibt den n-ten Tag des Monats an. Beispiele für das Feld „Wochentag“:

  • 3#4 – vierter Dienstag des Monats

  • 5#2 – zweiter Donnerstag des Monats

Beispiele

Nachfolgend finden Sie einige Beispiele für Cron-Zeitpläne.

Stündlich

Wird jede Stunde in Minute 15 ausgeführt:

15 * * * *

Täglich

Wird täglich um 22:00 Uhr ausgeführt:

0 22 * * *

Wird täglich jede Minute der Stunde nach 22:00 Uhr ausgeführt:

* 22 * * *

Wöchentlich

Wird jeden Dienstag um 03:00 Uhr ausgeführt:

0 3 * * 2

An Werktagen

Wird an jedem Werktag um 20:00 Uhr ausgeführt:

0 20 * * 1-5

Beachten Sie, dass der oben genannte Zeitplan am Montagabend um 20:00 Uhr und an jedem Abend der Woche zu diesem Zeitpunkt ausgeführt wird.

Wenn es um Aktivitäten am Vormittag jedes Werktags geht, können Sie die Zeitpläne am Sonntag starten, wobei der Wochentagswert mit 0 beginnt und mit 4 endet.

Monatlich

Wird am ersten Tag jedes Monats um 02:30 Uhr ausgeführt:

30 2 1 * *

Wird am nächsten Werktag (W) zum 25. des Monats um 15:30 Uhr ausgeführt:

30 15 25W * *
  • Wenn der 25. ein Samstag ist, wird das oben genannte am Freitag, den 24. ausgelöst.

  • Wenn der 25. ein Sonntag ist, wird das oben genannte am Montag, den 26. ausgelöst.

Jährlich

Wird jedes Jahr am 1. Januar um Mitternacht ausgeführt:

0 0 1 1 * *

Weitere Beispiele

Ausdruck

Bedeutung

0 12 * * *

Wird jeden Tag um 12:00 Uhr (mittags) ausgelöst

15 10 * * *

Wird jeden Tag um 10:15 Uhr ausgelöst

15 10 * * *

Wird jeden Tag um 10:15 Uhr ausgelöst

15 10 * * * *

Wird jeden Tag um 10:15 Uhr ausgelöst

15 10 * * * 2017

Wird im Jahr 2017 jeden Tag um 10:15 Uhr ausgelöst

* 14 * * *

Wird täglich jede Minute von 14:00 Uhr bis 14:59 Uhr ausgelöst

0/5 14 * * *

Wird täglich alle 5 Minuten von 14:00 Uhr bis 14:55 Uhr ausgelöst

0/5 14,18 * * *

Wird täglich alle 5 Minuten von 14:00 Uhr bis 14:55 Uhr UND alle 5 Minuten von 18:00 Uhr bis 18:55 Uhr ausgelöst

0-5 14 * * *

Wird täglich jede Minute von 14:00 Uhr bis 14:05 Uhr ausgelöst

10,44 14 * 3 WED

Wird jeden Mittwoch im März um 14:10 Uhr und um 14:44 Uhr ausgelöst

15 10 * * MON-FRI

Wird jeden Montag, Dienstag, Mittwoch, Donnerstag und Freitag um 10:15 Uhr ausgelöst

15 10 15 * *

Wird am 15. jedes Monats um 10:15 Uhr ausgelöst

15 10 L * *

Wird am letzten Tag jedes Monats um 10:15 Uhr ausgelöst

15 10 L-2 * *

Wird am zweitletzten Tag jedes Monats um 10:15 Uhr ausgelöst

15 10 * * 5L

Wird am letzten Freitag jedes Monats um 10:15 Uhr ausgelöst

15 10 * * 5L 2017-2019

Wird in den Jahren 2017, 2018 und 2019 am letzten Freitag jedes Monats um 10:15 Uhr ausgelöst

15 10 * * 5#3

Wird am dritten Freitag jedes Monats um 10:15 Uhr ausgelöst

0 12 1/5 * *

Wird jeden Monat alle 5 Tage ab dem ersten Tag des Monats um 12:00 Uhr (mittags) ausgelöst

11 11 11 11 *

Wird jeden 11. November um 11:11 Uhr ausgelöst.

Nicht unterstützte Cron-Ausdrücke

Anmerkung

AAC unterstützt nicht das Mischen der Sonderzeichen / und - in denselben Ausdrücken.

Anstatt Bereiche in der Cron-Syntax auszudrücken, können Sie alle möglichen Optionen referenzieren.

Ungültiger Ausdruck

Gültiger Ausdruck

0 23 * 1-11/2 * *
0 23 * 2,4,6,8,10 * *

Ungültige Cron-Ausdrücke

Ausdruck

Bedeutung

Ursache

15 10 * * * 2001

Wird im Jahr 2001 jeden Tag um 10:15 Uhr ausgelöst

Dieser Cron-Ausdruck ist ungültig, weil er keine Ereignisse in der Zukunft generiert.

* * *

-

Der Cron-Ausdruck muss sechs oder sieben Felder enthalten.