summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex230
1 files changed, 230 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex b/Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex
new file mode 100644
index 00000000000..6c66efe6958
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex
@@ -0,0 +1,230 @@
+\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: