%
% systemd-time.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Systemd-time %%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Systemd-time - Kalender Ereignisse}
\marklabel{SYSTEMDTIMER}{}
\index{systemd-time}


\section{Allgemein}

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

    Beispiel: \\

    \begin{verbatim}
    Thu,Fri 2012-*-1,5 11:12:13
    \end{verbatim}

    Das Obige bezieht sich auf 11:12:13 des ersten oder f"unften 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"urzter (Wed) oder nicht abgek"urzter (Wednesday)
    Form (Gro"s-/Kleinschreibung spielt keine Rolle), getrennt durch
    Kommas. Die Angabe von zwei durch '..' getrennten Wochentagen
    bezieht sich auf einen Bereich zusammen h"angender Wochentage.
    ',' und '..' k"onnen frei kombiniert werden.

    Beispiel: \\

    \begin{verbatim}
    Mon, Tue, Wed, Thu, Fri, Sat, Sun
    \end{verbatim}


    In den Datums- und Zeitangaben kann jede Komponente als '*'
    angegeben werden, in diesem Fall wird jeder Wert "ubereinstimmen.
    Alternativ kann jede Komponente als Liste von durch Kommas getrennten
    Werten angegeben werden. Werten k"onnen ein '/' und ein
    Wiederholungswert angeh"angt werden, was anzeigt, dass der Wert selbst
    und der Wert plus alle Vielfachen des Wiederholungswerts
    "ubereinstimmen. Zwei durch '..' getrennte Werte k"onnen verwendet
    werden, um einen Wertebereich anzugeben; Bereiche k"onnen 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"uche enthalten. Alle Br"uche werden auf 6
    Dezimalstellen gerundet.


    Entweder Zeit- oder Datumsangaben k"onnen 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"ortliche Zeichenfolge 'UTC' oder als lokale
    Zeitzone angegeben werden, "ahnlich der unterst"utzten Syntax von
    Zeitstempeln, oder als Zeitzone im IANA-Zeitzonendatenbankformat.



\section{Beispiele}

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

    \begin{verbatim}
    DayOfWeek Year-Month-Day Hour:Minute:Second
    \end{verbatim}


    Beispiele: \\

    Ein Sternchen kann verwendet werden, um einen beliebigen Wert
    anzugeben, und Kommas k"onnen verwendet werden, um m"ogliche Werte
    aufzulisten. Zwei durch '..' getrennte Werte zeigen einen
    zusammenh"angenden Bereich an.


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

    \begin{verbatim}
    OnCalendar=Mon,Tue *-*-01..04 12:00:00
    \end{verbatim}


    Um einen Dienst am ersten Samstag jedes Monats auszuf"uhren,
    verwenden Sie:

    \begin{verbatim}
    OnCalendar=Sat *-*-1..7 18:00:00
    \end{verbatim}


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

    \begin{verbatim}
    OnCalendar=*-*-* 4:00:00
    \end{verbatim}


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

    \begin{verbatim}
    OnCalendar=Mon..Fri 22:30
    OnCalendar=Sat,Sun 20:00
    \end{verbatim}



    Die folgenden speziellen Ausdr"ucke k"onnen als Abk"urzungen f"ur
    l"angere normalisierte Formen verwendet werden:


  \begin{tabular}{lrll}
  &     minutely & \pfeil & *-*-* *:*:00 \\
  &       hourly & \pfeil & *-*-* *:00:00 \\
  &        daily & \pfeil & *-*-* 00:00:00 \\
  &      monthly & \pfeil & *-*-01 00:00:00 \\
  &       weekly & \pfeil & Mon *-*-* 00:00:00 \\
  &       yearly & \pfeil & *-01-01 00:00:00 \\
  &    quarterly & \pfeil & *-01,04,07,10-01 00:00:00 \\
  & semiannually & \pfeil & *-01,07-01 00:00:00 \\
  \end{tabular}


    Beispiele für g"ultige Zeitstempel und deren normalisierte Form:


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


