diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex | 127 |
1 files changed, 68 insertions, 59 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex index ab623a72867..3143fad6583 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrdatetime.tex +++ b/Master/texmf-dist/source/latex/koma-script/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}) |