summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex')
-rw-r--r--macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex127
1 files changed, 68 insertions, 59 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex
index ab623a7286..3143fad658 100644
--- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex
+++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex
@@ -46,7 +46,7 @@
% ======================================================================
\KOMAProvidesFile{scrdatetime.tex}
- [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
+ [$Date: 2019-11-15 08:07:56 +0100 (Fri, 15 Nov 2019) $
KOMA-Script guide (chapter: scrdate, scrtime)]
\chapter{Der Wochentag mit \Package{scrdate}}
@@ -54,9 +54,14 @@
\BeginIndexGroup
\BeginIndex{Package}{scrdate}
+\iffalse% Varianten
Ursprünglich sollte das Paket \Package{scrdate} lediglich den Wochentag zum
aktuellen Datum liefern. Inzwischen bietet es dies und etwas mehr für jedes
-beliebige Datum im Gregorianischen Kalender.
+beliebige Datum im Gregorianischen Kalender.%
+\else%
+Vor \the\numexpr\year-1995\relax{} Jahren nur für die Ausgabe des aktuellen
+Wochentags entwickelt, bietet \Package{scrdate} inzwischen einiges mehr.
+\fi
\begin{Declaration}
\Macro{CenturyPart}\Parameter{Jahr}
@@ -69,8 +74,8 @@ Einer und Zehner. Dabei darf die Jahreszahl beliebig viele Stellen aufweisen.
Der Wert kann direkt zur Zuweisung an einen Zähler oder für Berechnungen mit
Hilfe von \Macro{numexpr}\IndexCmd{numexpr} verwendet werden. Für die
Ausgabe\textnote{Achtung!} als arabische Zahl ist \Macro{the}\IndexCmd{the}
-voran zu stellen.
-
+voranzustellen.
+%
\begin{Example}
Sie wollen berechnen, in welchem Jahrhundert das aktuelle Jahr liegt und
dies ausgeben.
@@ -81,18 +86,15 @@ voran zu stellen.
Jahrhunderts.
\end{lstcode}
Als Ergebnis erhalten Sie:
- \begin{quote}
+ \begin{ShowOutput}
Das Jahr \the\year\ ist das Jahr \the\DecadePart{\year} des \the\numexpr
\CenturyPart{\year}+1\relax. Jahrhunderts.
- \end{quote}
+ \end{ShowOutput}
+ Durch die Korrektur der Ordnungszahl mit \Macro{numexpr} wäre 2000
+ übrigens das Jahr 0 des 21.~Jahrhunderts.
\end{Example}%
-
-Bitte\textnote{Achtung!} beachten Sie, dass hier die Zählweise verwendet
-wird, bei der das Jahr 2000 das Jahr~0 -- also das erste Jahr -- des
-21.~Jahrhunderts ist. Bei Bedarf kann aber, wie im Beispiel für die
-Ordnungszahl gezeigt, mit \Macro{numexpr} eine Korrektur herbeigeführt
-werden.%
-\EndIndexGroup
+\EndIndexGroup%
+\ExampleEndFix
\begin{Declaration}
@@ -103,7 +105,7 @@ Diese\ChangedAt{v3.05a}{\Package{scrdate}} beiden Anweisungen geben den Wert
der Nummer des Wochentags\Index{Wochentag} zu einem Datum zurück. Sie
unterscheiden sich nur in der Art der Angabe des Datums. Während bei
\Macro{DayNumber} Jahr, Monat und Tag des gewünschten Datums eigene Parameter
-sind, wird bei \Macro{ISODayNumber} das Datum in ISO-Schreibweise,
+sind, wird bei \Macro{ISODayNumber} das Datum in ISO-Schreibweise
\PName{Jahr}\texttt{-}\PName{Monat}\texttt{-}\PName{Tag} angegeben. Dabei
spielt es keine Rolle, ob Monat und Tag ein- oder zweistellig angegeben
werden. Der Wert kann direkt zur Zuweisung an einen Zähler oder für
@@ -118,10 +120,10 @@ werden. Für die Ausgabe\textnote{Achtung!} als arabische Zahl ist
\the\ISODayNumber{2027-5-1}.
\end{lstcode}
Als Ergebnis erhalten Sie:
- \begin{quote}
+ \begin{ShowOutput}
Der 1.~Mai~2027 hat die Wochentagsnummer
\the\ISODayNumber{2027-5-1}.
- \end{quote}
+ \end{ShowOutput}
\end{Example}
Als Besonderheit ist es sogar möglich, von einem vorgegebenen Datum eine
@@ -137,13 +139,13 @@ gewünschte Anzahl an Tagen in die Zukunft oder Vergangenheit zu gehen.
gewesen sein.
\end{lstcode}
Als Ergebnis erhalten Sie beispielsweise:
- \begin{quote}
+ \begin{ShowOutput}
In 12~Tagen haben wir die Wochentagsnummer
\the\DayNumber{\year}{\month}{\day+12} und
24~Tage vor dem 24.~Dezember~2027 wird es
die Nummer \the\ISODayNumber{2027-12-24-24}
gewesen sein.
- \end{quote}
+ \end{ShowOutput}
\end{Example}
Die Wochentage werden dabei wie folgt nummeriert: Sonntag\,=\,0, Montag\,=\,1,
@@ -174,18 +176,18 @@ einem bestimmten Datum.
den 24.\,12.~2027, die Summe von \dots
\end{lstcode}
Als Ergebnis erhalten Sie:
- \begin{quote}
+ \begin{ShowOutput}
Bitte zahlen Sie bis zum
\ISODayName{2027-12-24}, den
24.\,12.~2027, die Summe von \dots
- \end{quote}
+ \end{ShowOutput}
\end{Example}
Als Besonderheit ist es auch hier möglich, in gewissem Umfang Berechnungen
anzustellen:
\begin{Example}
Sie wollen den Wochentag wissen, den wir in 12~Tagen haben und
- den wir 24~Tage vor dem 24.~Dezember~2027 hatten.
+ den wir 24~Tage vor dem 24.~Dezember~2027 gehabt haben werden.
\begin{lstcode}
In 12~Tagen haben wir einen
\DayName{\year}{\month}{\day+12} und
@@ -195,7 +197,7 @@ anzustellen:
\DayNameByNumber{3+2*7+3} folgt.
\end{lstcode}
Als Ergebnis erhalten Sie beispielsweise:
- \begin{quote}
+ \begin{ShowOutput}
In 12~Tagen haben wir einen
\DayName{\year}{\month}{\day+12} und
24~Tage vor dem 24.~Dezember~2027 ist ein
@@ -203,10 +205,11 @@ anzustellen:
zwei Wochen und drei Tage nach
einem Mittwoch ein \DayNameByNumber{3+2*7+3}
folgt.
- \end{quote}
+ \end{ShowOutput}
\end{Example}%
%
\EndIndexGroup
+\ExampleEndFix
\begin{Declaration}
@@ -225,8 +228,8 @@ zweistellig ausgibt, während \Macro{IsoToday} Monat und Tag bei Werten kleiner
10 einstellig ausgibt. Die Anweisung \Macro{todaysname} bietet direkt den
aktuellen Wochentag, während \Macro{todaysnumber} den Wert des aktuellen
Wochentags liefert. Näheres zur Verwendung dieses Wertes ist den obigen
-Erklärungen zu den Anweisungen \DescRef{scrdate.cmd.DayNumber} und \DescRef{scrdate.cmd.ISODayNumber} zu
-entnehmen.
+Erklärungen zu den Anweisungen \DescRef{scrdate.cmd.DayNumber} und
+\DescRef{scrdate.cmd.ISODayNumber} zu entnehmen.
\begin{Example}
Ich will Ihnen zeigen, an was für einem Wochentag dieses Dokument gesetzt
@@ -235,9 +238,9 @@ entnehmen.
Dieses Dokument entstand an einem \todaysname.
\end{lstcode}
Das Ergebnis lautet:
- \begin{quote}
+ \begin{ShowOutput}
Dieses Dokument entstand an einem \todaysname.
- \end{quote}
+ \end{ShowOutput}
\end{Example}
\begin{Explain}
@@ -245,7 +248,6 @@ entnehmen.
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. Greifen Sie mit
- % Umbruchkorrektur: listings
\begin{lstcode}
\MakeLowercase{\todaysname}
\end{lstcode}
@@ -253,7 +255,8 @@ entnehmen.
\Macro{MakeLowercase}\IndexCmd{MakeLowercase}%
\important{\Macro{MakeLowercase}} zurück. Diese wandelt ihr Argument
komplett in Kleinbuchstaben. Natürlich funktioniert dieser Tipp auch für
- obige Anweisungen \DescRef{scrdate.cmd.DayNameByNumber}\IndexCmd{DayNameByNumber},
+ obige Anweisungen
+ \DescRef{scrdate.cmd.DayNameByNumber}\IndexCmd{DayNameByNumber},
\DescRef{scrdate.cmd.DayName}\IndexCmd{DayName} und
\DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName}.%
\end{Explain}%
@@ -275,13 +278,13 @@ von \DescRef{scrdate.cmd.todaysname} auf den Wert \PName{Name}.
\end{lstcode}
und erhalten so mit dem Satz aus dem vorherigen Beispiel zu
\DescRef{scrdate.cmd.todaysname}:
- \begin{quote}\nameday{Werktag}
+ \begin{ShowOutput}\nameday{Werktag}
Dieses Dokument entstand an einem {\todaysname}.
- \end{quote}
+ \end{ShowOutput}
\end{Example}
Für \DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} und
-\DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday} existieren keine entsprechenden
-Anweisungen.%
+\DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday} existieren keine
+entsprechenden Anweisungen.%
\EndIndexGroup
@@ -346,10 +349,13 @@ werden.%
\BeginIndex{Package}{scrtime}
Mit Hilfe dieses Pakets kann die Frage nach der aktuellen Zeit beantwortet
-werden. Seit Version~3.05 unterstützt das Paket auch die von den
+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}.
+\autoref{sec:typearea.options}.%
+\fi
\begin{Declaration}%
\Macro{thistime}\OParameter{Trennung}
@@ -371,43 +377,45 @@ erweitert wird.
Ihr Zug geht um \thistime\ Uhr.
\end{lstcode}
liefert als Ergebnis beispielsweise eine Zeile wie
- \begin{quote}
+ \begin{ShowOutput}
Ihr Zug geht um \thistime\ Uhr.
- \end{quote}
+ \end{ShowOutput}
oder
- \begin{quote}
+ \begin{ShowOutput}
Ihr Zug geht um 23:09 Uhr.
- \end{quote}
- \bigskip
+ \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{quote}
+ \begin{ShowOutput}
Beim nächsten Ton ist es 8\ Uhr,\ 41 Minuten und 42 Sekunden.
- \end{quote}
+ \end{ShowOutput}
oder
- \begin{quote}
+ \begin{ShowOutput}
Beim nächsten Ton ist es 23\ Uhr,\ 9 Minuten und 42 Sekunden.
- \end{quote}
+ \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}%
+\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.%
+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
@@ -416,20 +424,21 @@ festgelegt wurde.%
\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.%
+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 als Klassenoption bei
+Die Option kann wahlweise global per
\DescRef{typearea.cmd.documentclass}, als Paketoption bei
-\DescRef{typearea.cmd.usepackage} oder auch nach dem Laden von
+\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})