Unterabschnitte


Systemd-time - Kalender Ereignisse

Allgemein

Kalenderereignisse können verwendet werden, um in einem einzigen Ausdruck auf einen oder mehrere Zeitpunkte zu verweisen.

Beispiel:

    Thu,Fri 2012-*-1,5 11:12:13

Das Obige bezieht sich auf 11:12:13 des ersten oder fünften Tages eines beliebigen Monats des Jahres 2012, aber nur, wenn dieser Tag ein Donnerstag oder Freitag ist.

Die Angabe des Wochentags ist optional. Falls angegeben, sollte er aus einem oder mehreren englischsprachigen Wochentagsnamen bestehen, entweder in abgekürzter (Wed) oder nicht abgekürzter (Wednesday) Form (Groß-/Kleinschreibung spielt keine Rolle), getrennt durch Kommas. Die Angabe von zwei durch '..' getrennten Wochentagen bezieht sich auf einen Bereich zusammen hängender Wochentage. ',' und '..' können frei kombiniert werden.

Beispiel:

    Mon, Tue, Wed, Thu, Fri, Sat, Sun

In den Datums- und Zeitangaben kann jede Komponente als '*' angegeben werden, in diesem Fall wird jeder Wert übereinstimmen. Alternativ kann jede Komponente als Liste von durch Kommas getrennten Werten angegeben werden. Werten können ein '/' und ein Wiederholungswert angehängt werden, was anzeigt, dass der Wert selbst und der Wert plus alle Vielfachen des Wiederholungswerts übereinstimmen. Zwei durch '..' getrennte Werte können verwendet werden, um einen Wertebereich anzugeben; Bereiche können auch mit '/' und einem Wiederholungswert gefolgt werden, dann passt der Ausdruck auf alle Zeiten, beginnend mit dem Startwert, und weiter mit allen Vielfachen des Wiederholungswerts relativ zum Startwert, endet spätestens mit dem Endwert.

Eine Datumsangabe kann ' ' verwenden, um den letzten Tag in einem Monat anzugeben. Zum Beispiel bedeutet '*-02 03' 'der drittletzte Tag im Februar' und 'Mon *-05 07/1' bedeutet 'der letzte Montag im Mai'.

Die Sekundenkomponente darf sowohl im Wert als auch in der Wiederholung Dezimalbrüche enthalten. Alle Brüche werden auf 6 Dezimalstellen gerundet.

Entweder Zeit- oder Datumsangaben können weggelassen werden, wobei in diesem Fall der aktuelle Tag bzw. 00:00:00 impliziert wird. Wird die zweite Komponente nicht angegeben, wird ':00' angenommen.

Die Zeitzone kann als wörtliche Zeichenfolge 'UTC' oder als lokale Zeitzone angegeben werden, ähnlich der unterstützten Syntax von Zeitstempeln, oder als Zeitzone im IANA-Zeitzonendatenbankformat.

Beispiele

Wenn genauere Datums- und Uhrzeitangaben erforderlich sind, verwenden OnCalendar-Ereignisse das folgende Format:

    DayOfWeek Year-Month-Day Hour:Minute:Second

Beispiele:

Ein Sternchen kann verwendet werden, um einen beliebigen Wert anzugeben, und Kommas können verwendet werden, um mögliche Werte aufzulisten. Zwei durch '..' getrennte Werte zeigen einen zusammenhängenden Bereich an.

Im folgenden Beispiel wird der Dienst an den ersten vier Tagen jedes Monats um 12:00 Uhr ausgeführt, aber nur, wenn dieser Tag ein Montag oder Dienstag ist.

    OnCalendar=Mon,Tue *-*-01..04 12:00:00

Um einen Dienst am ersten Samstag jedes Monats auszuführen, verwenden Sie:

    OnCalendar=Sat *-*-1..7 18:00:00

Bei Verwendung des DayOfWeek-Teils muss mindestens ein Wochentag angegeben werden. Wenn Sie möchten, dass jeden Tag um 4 Uhr morgens etwas ausgeführt wird, verwenden Sie:

    OnCalendar=*-*-* 4:00:00

Um einen Dienst zu unterschiedlichen Zeiten auszuführen, kann OnCalendar mehr als einmal angegeben werden. Im Beispiel unten läuft der Dienst wochentags um 22:30 Uhr und am Wochenende um 20:00 Uhr.

    OnCalendar=Mon..Fri 22:30
    OnCalendar=Sat,Sun 20:00

Die folgenden speziellen Ausdrücke können als Abkürzungen für längere normalisierte Formen verwendet werden:

  minutely *-*-* *:*:00
  hourly *-*-* *:00:00
  daily *-*-* 00:00:00
  monthly *-*-01 00:00:00
  weekly Mon *-*-* 00:00:00
  yearly *-01-01 00:00:00
  quarterly *-01,04,07,10-01 00:00:00
  semiannually *-01,07-01 00:00:00

Beispiele für gültige Zeitstempel und deren normalisierte Form:

  Sat,Thu,Mon..Wed,Sat..Sun Mon..Thu,Sat,Sun *-*-* 00:00:00
  Mon,Sun 12-*-* 2,1:23 Mon,Sun 2012-*-* 01,02:23:00
  Wed *-1 Wed *-*-01 00:00:00
  Wed..Wed,Wed *-1 Wed *-*-01 00:00:00
  Wed, 17:48 Wed *-*-* 17:48:00
  Wed..Sat,Tue 12-10-15 1:2:3 Tue..Sat 2012-10-15 01:02:03
  *-*-7 0:0:0 *-*-07 00:00:00
  10-15 *-10-15 00:00:00
  monday *-12-* 17:00 Mon *-12-* 17:00:00
  Mon,Fri *-*-3,1,2 *:30:45 Mon,Fri *-*-01,02,03 *:30:45
  12,14,13,12:20,10,30 *-*-* 12,13,14:10,20,30:00
  12..14:10,20,30 *-*-* 12..14:10,20,30:00
  mon,fri *-1/2-1,3 *:30:45 Mon,Fri *-01/2-01,03 *:30:45
  03-05 08:05:40 *-03-05 08:05:40
  08:05:40 *-*-* 08:05:40
  05:40 *-*-* 05:40:00
  Sat,Sun 12-05 08:05:40 Sat,Sun *-12-05 08:05:40
  Sat,Sun 08:05:40 Sat,Sun *-*-* 08:05:40
  2003-03-05 05:40 2003-03-05 05:40:00
  05:40:23.4200004/3.1700005 *-*-* 05:40:23.420000/3.170001
  2003-02..04-05 2003-02..04-05 00:00:00
  2003-03-05 05:40 UTC 2003-03-05 05:40:00 UTC
  2003-03-05 2003-03-05 00:00:00
  03-05 *-03-05 00:00:00
  hourly *-*-* *:00:00
  daily *-*-* 00:00:00
  daily UTC *-*-* 00:00:00 UTC
  monthly *-*-01 00:00:00
  weekly Mon *-*-* 00:00:00
  weekly Pacific/Auckland Mon *-*-* 00:00:00 Pacific/Auckland
  yearly *-01-01 00:00:00
  annually *-01-01 00:00:00
  *:2/3 *-*-* *:02/3:00