summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/doc/scrtime-de.tex
blob: 84b3e8c21292b257e6ad9610b333d954de460493 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
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: