\ProvidesFile{datmzeit.tex}[2004/09/05 KOMA-Script Anleitung]
% ============================================================================
% datmzeit.tex
% Copyright (c) 2001-2004 Markus Kohm and the authors.
%
% This file is part of the LaTeX2e KOMA-Script-Bundle
%
% This file can be redistributed and/or modified under the terms of the LaTeX
% Project Public License Version 1.0 distributed together with this file. See
% LEGAL.TXT or LEGALDE.TXT.
%
% This bundle is written specialy for use at german-language. So the main
% documentation is german. There may also be an english documentation. See
% readme.txt, if you search for it.
% ----------------------------------------------------------------------------
% datmzeit.tex
% Copyright (c) 2001-2004 Markus Kohm und bei den weiteren Autoren.
%
% Diese Datei ist Teil des LaTeX2e KOMA-Script-Pakets.
%
% Diese Datei kann nach den Regeln der LaTeX Project Public Licence
% Version 1.0, wie sie zusammen mit dieser Datei verteilt wird,
% weiterverbreitet und/oder modifiziert werden. Siehe dazu auch LEGAL.TXT oder
% LEGALDE.TXT.
%
% Dieses Paket ist fuer den deutschen Sprachraum konzipiert. Daher ist auch
% diese Anleitung komplett in Deutsch. Moeglicherweise existiert auch eine
% englische Version der Anleitung. Falls Sie eine solche benoetigen, schauen
% Sie bitte in liesmich.txt nach, ob eine solche vorhanden ist.
% ============================================================================
%
% Modul:    Datum- und Zeitroutinen
% Autoren:  Markus Kohm (MJK) <markus.kohm@gmx.de>
% Inhalt:   Erweiterte Ausgaben von Datum und Zeit mit scrdate und scrtime
% Sprache:  Deutsch
% Zeichensatz der Kommentare:
%           US-ASCII
%

\chapter{Wochentag und Uhrzeit mit \Package{scrdate} und \Package{scrtime}}
\label{cha:datetime}

Zu \KOMAScript{} gehören auch zwei Pakete, um den Umgang mit
Datum\Index{Datum} und Zeit\Index{Zeit} über die beiden
Standardbefehle \Macro{today} und \Macro{date} hinaus zu
erweitern. Ebenso wie die anderen Pakete aus {\KOMAScript} können
diese Pakete auch mit den Standardklassen verwendet werden.

\section{Der aktuelle Wochentag mit \Package{scrdate}}
\label{sec:datetime.scrdate}
\BeginIndex{Package}{scrdate}

\begin{Declaration}
  \Macro{todaysname}
\end{Declaration}%
\BeginIndex{Cmd}{todaysname}%
Bekanntlich erhält man mit \Macro{today}\IndexCmd{today} das aktuelle
Datum in der landestypischen Schreibweise. \Package{scrdate} bietet
mit \Macro{todaysname} eine Anweisung, um den aktuellen Wochentag zu
erhalten.
\begin{Example}
  Sie wollen in Ihrem Dokument ausgeben, an welchem Tag es mit
  \LaTeX{} in eine \File{dvi}-Datei übersetzt wurde. Sie schreiben
  dazu
  \begin{small}
\begin{verbatim}
  Dieses Dokument wurde an einem {\todaysname} übersetzt.
\end{verbatim}
  \end{small}
  und erhalten beispielsweise:
  \begin{quote}
    Dieses Dokument wurde an einem {\todaysname} übersetzt.
  \end{quote}
\end{Example}
\begin{Explain}
  \textbf{Tipp:} Wenn Sie den Namen des Tages in Kleinbuchstaben
  benötigen, weil das in der entsprechenden Sprache innerhalb des
  Satzes so üblich ist, können Sie das erreichen, obwohl die Namen der
  Wochentage in \Package{scrdate} alle groß geschrieben sind. In
  diesem Fall können Sie einfach auf die \LaTeX-Anweisung
  \Macro{MakeLowercase} zurückgreifen und
  \Macro{MakeLowercase}\PParameter{\Macro{todaysname}} schreiben.
\end{Explain}
\EndIndex{Cmd}{todaysname}

\begin{Declaration}
  \Macro{nameday}\Parameter{Name}
\end{Declaration}%
\BeginIndex{Cmd}{nameday}%
So wie mit \Macro{date}\IndexCmd{date} die Ausgabe von \Macro{today}
direkt geändert werden kann, setzt \Macro{nameday} die Ausgabe von
\Macro{todaysname} auf den Wert \PName{Name}.
\begin{Example}
  Sie setzen mit \Macro{date} das aktuelle Datum auf einen festen
  Wert. Für die Ausgabe des zugehörigen Wochentags interessiert es nur,
  dass dieser Tag ein Werktag war. Daher schreiben Sie
  \begin{small}
\begin{verbatim}
  \nameday{Werktag}
\end{verbatim}
  \end{small}
  und erhalten so mit dem Satz aus dem vorherigen Beispiel:
  \begin{quote}\nameday{Werktag}
    Dieses Dokument wurde an einem {\todaysname} übersetzt.
  \end{quote}
\end{Example}
\EndIndex{Cmd}{nameday}

Das \Package{scrdate}-Paket beherrscht derzeit die Sprachen Englisch
(english and USenglish), Deutsch (german, ngerman und austrian),
Französisch (french), Italienisch (italian), Spanisch (spanish) und
Kroatisch (croatian), kann aber auch für andere Sprachen konfiguriert
werden. Näheres dazu entnehme man \File{scrdate.dtx}.

Bei der aktuellen Version ist es egal, ob \Package{scrdate} vor oder
nach \Package{german}\IndexPackage{german},
\Package{babel}\IndexPackage{babel} oder ähnlichen Paketen geladen
wird, in jedem Falle wird die korrekte Sprache
gewählt.

\begin{Explain}
  Etwas genauer ausgedrückt: Solange die Sprachauswahl in einer zu
  \Package{babel}\IndexPackage{babel} bzw.
  \Package{german}\IndexPackage{german} kompatiblen Form erfolgt und
  die Sprache \Package{scrdate} bekannt ist, wird die Sprache korrekt
  gewählt. Ist dies nicht der Fall, werden (US-)englische Ausdrücke
  verwendet.
\end{Explain}
\EndIndex{Package}{scrdate}

\section{Die aktuelle Zeit mit \Package{scrtime}}
\label{sec:datetime.scrtime}
\BeginIndex{Package}{scrtime}

\begin{Declaration}%
  \Macro{thistime}\OParameter{Trennung}\\
  \Macro{thistime*}\OParameter{Trennung}
\end{Declaration}%
\BeginIndex{Cmd}{thistime}\BeginIndex{Cmd}{thistime*}%
\Macro{thistime} liefert die aktuelle Zeit\Index{Zeit}. Als
Trennbuchstabe zwischen den Werten Stunden, Minuten und Sekunden
wird das optionale Argument \PName{Trennung} verwendet. Die
Voreinstellung ist hierbei das Zeichen "`\PValue{:}"'.

\Macro{thistime*} funktioniert fast genau wie \Macro{thistime}. Der
einzige Unterschied besteht darin, dass im Gegensatz zu
\Macro{thistime} bei \Macro{thistime*} die Minutenangaben bei Werten
kleiner 10 nicht durch eine vorangestellte Null auf zwei Stellen
erweitert wird.
\begin{Example}
  Die Zeile
  \begin{small}
\begin{verbatim}
  Ihr Zug geht um \thistime\ Uhr.
\end{verbatim}
  \end{small}
  liefert als Ergebnisse beispielsweise eine Zeile wie
  \begin{quote}
    Ihr Zug geht um \thistime\ Uhr.
  \end{quote}
  oder
  \begin{quote}
    Ihr Zug geht um 23:09 Uhr.
  \end{quote}
  \bigskip
  Demgegenüber liefert die Zeile
  \begin{small}
\begin{verbatim}
  Beim nächsten Ton ist es \thistime*[\ Uhr,\ ] Minuten und
  42 Sekunden.
\end{verbatim}
  \end{small}
  als mögliches Ergebniss etwas wie:
  \begin{quote}
    Beim nächsten Ton ist es \thistime*[\ Uhr,\ ] Minuten und 42 Sekunden.
  \end{quote}
  oder
  \begin{quote}
    Beim nächsten Ton ist es 23\ Uhr,\ 9 Minuten und 42 Sekunden.
  \end{quote}
\end{Example}
\EndIndex{Cmd}{thistime}\EndIndex{Cmd}{thistime*}

\begin{Declaration}%
 \Macro{settime}\Parameter{Wert}
\end{Declaration}%
\BeginIndex{Cmd}{settime}%
\Macro{settime} setzt die Ausgabe von \Macro{thistime} und
\Macro{thistime*} auf einen festen \PName{Wert}%
\footnote{Allerdings darf man nicht erwarten, dass nun die Zeit
  stillsteht!}. %
Anschließend wird das optionale Argument von \Macro{thistime} bzw.
\Macro{thistime*} ignoriert, da ja die komplette Zeichenkette, die
\Macro{thistime} bzw. \Macro{thistime*} nun liefert, hiermit explizit
festgelegt wurde.%
\EndIndex{Cmd}{settime}

\begin{Declaration}
  \Option{12h}\\
  \Option{24h}
\end{Declaration}%
\BeginIndex{Option}{12h}\BeginIndex{Option}{24h}%
Mit den Optionen \Option{12h} und \Option{24h} kann ausgewählt
werden, ob die Zeit bei \Macro{thistime} und \Macro{thistime*} im
12-Stunden- oder 24-Stunden-Format ausgegeben werden soll.
Voreingestellt ist \Option{24h}%
\footnote{Leider beherrscht das \Package{scrtime}-Paket noch nicht die
  Sternzeit nach \textsc{StarTrek}\Index{StarTrek}, ein echter
  Mangel!}. %
Die Option verliert bei einem Aufruf von \Macro{settime} ebenfalls ihre
Gültigkeit.%
\EndIndex{Option}{12h}\EndIndex{Option}{24h}
\EndIndex{Package}{scrtime}

\section{Autoren}
\label{sec:datetime.authors}
Die folgenden Autoren waren an diesem Kapitel beteiligt oder haben die Vorlage
dafür geliefert.
% In folgener Aufzaehlung den Namen des Autors, der fuer das Kapitel
% verantwortlich ist bitte mit \textbf{} hervorheben.
\begin{itemize}
\item Axel Sommerfeldt
\item Markus Kohm \TextEMail{Markus.Kohm@gmx.de}
\end{itemize}
Die Fußnoten stammen von Axel Sommerfeldt.

%%% Local Variables:
%%% mode: latex
%%% TeX-master: "scrguide2"
%%% End:
