diff options
Diffstat (limited to 'macros/latex/contrib/koma-script/doc/scrtime-de.tex')
-rw-r--r-- | macros/latex/contrib/koma-script/doc/scrtime-de.tex | 150 |
1 files changed, 150 insertions, 0 deletions
diff --git a/macros/latex/contrib/koma-script/doc/scrtime-de.tex b/macros/latex/contrib/koma-script/doc/scrtime-de.tex new file mode 100644 index 0000000000..84b3e8c212 --- /dev/null +++ b/macros/latex/contrib/koma-script/doc/scrtime-de.tex @@ -0,0 +1,150 @@ +% ====================================================================== +% scrtime-de.tex +% Copyright (c) Markus Kohm, 2001-2022 +% +% This file is part of the LaTeX2e KOMA-Script bundle. +% +% This work may be distributed and/or modified under the conditions of +% the LaTeX Project Public License, version 1.3c of the license. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3c or later is part of all distributions of LaTeX +% version 2005/12/01 or later and of this work. +% +% This work has the LPPL maintenance status "author-maintained". +% +% The Current Maintainer and author of this work is Markus Kohm. +% +% This work consists of all files listed in MANIFEST.md. +% ====================================================================== +% +% Chapter about scrtime of the KOMA-Script guide +% Maintained by Markus Kohm +% +% ====================================================================== + +\KOMAProvidesFile{scrtime-de.tex} + [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $ + KOMA-Script guide (chapter: scrdate, scrtime)] + +\chapter{Die aktuelle Zeit mit \Package{scrtime}} +\labelbase{scrtime} +\BeginIndexGroup +\BeginIndex{Package}{scrtime} + +Mit Hilfe dieses Pakets kann die Frage nach der aktuellen Zeit beantwortet +werden.% +\iffalse % Umbruchkorektur +\ Seit Version~3.05 unterstützt das Paket auch die von den +\KOMAScript-Klassen und diversen anderen \KOMAScript-Paketen bekannten +Möglichkeiten zur Angabe von Optionen. Siehe dazu beispielsweise +\autoref{sec:typearea.options}.% +\fi + +\begin{Declaration}% + \Macro{thistime}\OParameter{Trennung} + \Macro{thistime*}\OParameter{Trennung} +\end{Declaration}% +\Macro{thistime} liefert die aktuelle Zeit\Index{Zeit} in Stunden und +Minuten. In der Ausgabe wird zwischen den Stunden und Minuten das optionale +Argument \PName{Trennung} gesetzt. Voreingestellt ist 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{lstcode} + Ihr Zug geht um \thistime\ Uhr. +\end{lstcode} + liefert als Ergebnis beispielsweise eine Zeile wie + \begin{ShowOutput} + Ihr Zug geht um \thistime\ Uhr. + \end{ShowOutput} + oder + \begin{ShowOutput} + Ihr Zug geht um 23:09 Uhr. + \end{ShowOutput} + Demgegenüber liefert die Zeile +\begin{lstcode} + Beim nächsten Ton ist es \thistime*[\ Uhr,\ ] + Minuten und 42 Sekunden. +\end{lstcode} + als mögliches Ergebnis etwas wie + \begin{ShowOutput} + Beim nächsten Ton ist es 8\ Uhr,\ 41 Minuten und 42 Sekunden. + \end{ShowOutput} + oder + \begin{ShowOutput} + Beim nächsten Ton ist es 23\ Uhr,\ 9 Minuten und 42 Sekunden. + \end{ShowOutput} +\end{Example} +\EndIndexGroup +\ExampleEndFix + + +\begin{Declaration}% + \Macro{settime}\Parameter{Wert} +\end{Declaration}% +\DescRef{scrtime.cmd.settime} setzt die Ausgabe von +\DescRef{scrtime.cmd.thistime} und \DescRef{scrtime.cmd.thistime*} auf einen +festen \PName{Wert}% +%\footnote{Allerdings darf man nicht erwarten, dass nun die Zeit +% stillsteht!} +. % +Anschließend wird das optionale Argument von \DescRef{scrtime.cmd.thistime} +bzw. \DescRef{scrtime.cmd.thistime*} ignoriert, da ja die komplette +Zeichenkette, die \DescRef{scrtime.cmd.thistime} +bzw. \DescRef{scrtime.cmd.thistime*} nun liefert, hiermit explizit festgelegt +wurde.% +\EndIndexGroup + + +\begin{Declaration} + \OptionVName{12h}{Ein-Aus-Wert} +\end{Declaration}% +\BeginIndex{Option}{24h}% +Mit der Option \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} kann gewählt +werden, ob die Zeit bei \DescRef{scrtime.cmd.thistime} und +\DescRef{scrtime.cmd.thistime*} im 12-Stunden- oder 24-Stunden-Format +ausgegeben werden soll. Als \PName{Ein-Aus-Wert} kann dabei einer der +Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, +\autopageref{tab:truefalseswitch} verwendet werden. Wird die Option ohne +Wert-Angabe verwendet, so wird der Wert \PValue{true} angenommen, also auf das +12-Stunden-Format geschaltet. Voreingestellt\textnote{Voreinstellung} ist +hingegen das 24-Stunden-Format.% +%\footnote{Leider beherrscht das \Package{scrtime}-Paket noch nicht die +% Sternzeit nach \textsc{StarTrek}\Index{StarTrek}, ein echter +% Mangel!} + +Die Option kann wahlweise global per +\DescRef{typearea.cmd.documentclass}, als Paketoption bei +\DescRef{typearea.cmd.usepackage} oder nach dem Laden von +\Package{scrtime} per \DescRef{typearea.cmd.KOMAoptions} oder +\DescRef{typearea.cmd.KOMAoption} (siehe beispielsweise +\autoref{sec:typearea.options}, \DescPageRef{typearea.cmd.KOMAoptions}) +gesetzt werden. Sie verliert jedoch bei einem Aufruf von +\DescRef{scrtime.cmd.settime} ihre Gültigkeit. Die Uhrzeit wird nach +Verwendung dieser Anweisung nur noch mit dem dort angegebenen Wert im dort +verwendeten Format ausgegeben. + +Rein\textnote{Achtung!} aus Gründen der Kompatibilität zu früheren Versionen +von \Package{scrtime} wird bei \DescRef{typearea.cmd.documentclass} und +\DescRef{typearea.cmd.usepackage} auch noch die Option \Option{24h} zur +Umschaltung auf das 24-Stunden-Format unterstützt. Deren Verwendung wird +jedoch nicht mehr empfohlen.% +\EndIndexGroup +% +\EndIndexGroup + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: "scrguide-de.tex" +%%% coding: utf-8 +%%% ispell-local-dictionary: "de_DE" +%%% eval: (flyspell-mode 1) +%%% End: + |