diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-11 23:54:18 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-11 23:54:18 +0000 |
commit | 75553bd842302454a6c00a4df2cc016411d7a4b4 (patch) | |
tree | 19ab91c01a81b7aac6e04f6a324476c3e94d191d /Master/texmf-dist/source/latex/koma-script/scrguide/datmzeit.tex | |
parent | b6997fafa1ead62e91af07d4b8ccaca942d7eb42 (diff) |
trunk/Master/texmf-dist/source/latex/koma-script
git-svn-id: svn://tug.org/texlive/trunk@342 c570f23f-e606-0410-a88d-b1316a301751
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.tex | 230 |
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: |