\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{} gehren 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} knnen
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 erhlt 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
  bentigen, weil das in der entsprechenden Sprache innerhalb des
  Satzes so blich ist, knnen Sie das erreichen, obwohl die Namen der
  Wochentage in \Package{scrdate} alle gro geschrieben sind. In
  diesem Fall knnen Sie einfach auf die \LaTeX-Anweisung
  \Macro{MakeLowercase} zurckgreifen 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 gendert 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. Fr die Ausgabe des zugehrigen 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),
Franzsisch (french), Italienisch (italian), Spanisch (spanish) und
Kroatisch (croatian), kann aber auch fr andere Sprachen konfiguriert
werden. Nheres 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
gewhlt.

\begin{Explain}
  Etwas genauer ausgedrckt: 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
  gewhlt. Ist dies nicht der Fall, werden (US-)englische Ausdrcke
  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
  Demgegenber liefert die Zeile
  \begin{small}
\begin{verbatim}
  Beim nchsten Ton ist es \thistime*[\ Uhr,\ ] Minuten und
  42 Sekunden.
\end{verbatim}
  \end{small}
  als mgliches Ergebniss etwas wie:
  \begin{quote}
    Beim nchsten Ton ist es \thistime*[\ Uhr,\ ] Minuten und 42 Sekunden.
  \end{quote}
  oder
  \begin{quote}
    Beim nchsten 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!}. %
Anschlieend 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 ausgewhlt
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
Gltigkeit.%
\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
dafr 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 Funoten stammen von Axel Sommerfeldt.

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