<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">% ======================================================================
% scrdate-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 scrdate of the KOMA-Script guide
% Maintained by Markus Kohm
%
% ======================================================================

\KOMAProvidesFile{scrdate-de.tex}
                 [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $
                  KOMA-Script guide (chapter: scrdate, scrtime)]

\chapter{Der Wochentag mit \Package{scrdate}}
\labelbase{scrdate}
\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.%
\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}
  \Macro{DecadePart}\Parameter{Jahr}
\end{Declaration}%
Die\ChangedAt{v3.05a}{\Package{scrdate}} Anweisung \Macro{CenturyPart} ergibt
den Wert der Jahrhundert-Stellen eines Jahres. Die Anweisung
\Macro{DecadePart} ergibt hingegen den Wert der Ã¼brigen Stellen, also der
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}
voranzustellen.
%
\begin{Example}
  Sie wollen berechnen, in welchem Jahrhundert das aktuelle Jahr liegt und
  dies ausgeben.
\begin{lstcode}
  Das Jahr \the\year\ ist das Jahr 
  \the\DecadePart{\year} des 
  \the\numexpr \CenturyPart{\year}+1\relax. 
  Jahrhunderts.
\end{lstcode}
  Als Ergebnis erhalten Sie:
  \begin{ShowOutput}
    Das Jahr \the\year\ ist das Jahr \the\DecadePart{\year} des \the\numexpr
    \CenturyPart{\year}+1\relax.  Jahrhunderts.
  \end{ShowOutput}
  Durch die Korrektur der Ordnungszahl mit \Macro{numexpr} wÃ¤re 2000
  Ã¼brigens das Jahr 0 des 21.~Jahrhunderts.
\end{Example}%
\EndIndexGroup%
\ExampleEndFix


\begin{Declaration}
  \Macro{DayNumber}\Parameter{Jahr}\Parameter{Monat}\Parameter{Tag}
  \Macro{ISODayNumber}\Parameter{ISO-Datum}
\end{Declaration}%
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
\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
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.

\begin{Example}
  Sie wollen die Nummer des Wochentags des 1.~Mai~2027 wissen.
\begin{lstcode}
  Der 1.~Mai~2027 hat die Wochentagsnummer 
  \the\ISODayNumber{2027-5-1}.
\end{lstcode}
  Als Ergebnis erhalten Sie:
  \begin{ShowOutput}
    Der 1.~Mai~2027 hat die Wochentagsnummer 
    \the\ISODayNumber{2027-5-1}.
  \end{ShowOutput}
\end{Example}

Als Besonderheit ist es sogar mÃ¶glich, von einem vorgegebenen Datum eine
gewÃ¼nschte Anzahl an Tagen in die Zukunft oder Vergangenheit zu gehen.
\begin{Example}
  Sie wollen die Nummer des Wochentags wissen, den wir in 12~Tagen haben und
  den wir 24~Tage vor dem 24.~Dezember~2027 gehabt haben werden.
\begin{lstcode}
  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{lstcode}
  Als Ergebnis erhalten Sie beispielsweise:
  \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{ShowOutput}
\end{Example}

Die Wochentage werden dabei wie folgt nummeriert: Sonntag\,=\,0, Montag\,=\,1,
Dienstag\,=\,2, Mittwoch\,=\,3, Donnerstag\,=\,4, Freitag\,=\,5 und
Samstag\,=\,6.%
%
\EndIndexGroup


\begin{Declaration}
  \Macro{DayNameByNumber}\Parameter{Wochentagsnummer}
  \Macro{DayName}\Parameter{Jahr}\Parameter{Monat}\Parameter{Tag}
  \Macro{ISODayName}\Parameter{ISO-Datum}
\end{Declaration}%
Ãœblicherweise\ChangedAt{v3.05a}{\Package{scrdate}} ist man weniger an der
Nummer eines Wochentags als dem Namen des Wochentags interessiert. Daher
liefert die Anweisung \Macro{DayNameByNumber} den Namen des Wochentags zu
einer Wochentagsnummer zurÃ¼ck, die man beispielsweise mit einer der beiden
zuvor erklÃ¤rten Anweisungen \DescRef{\LabelBase.cmd.DayNumber} oder
\DescRef{\LabelBase.cmd.ISODayNumber} bestimmt hat. Die beiden Anweisungen
\Macro{DayName} und \Macro{ISODayName} liefern entsprechend den Wochentag zu
einem bestimmten Datum.

\begin{Example}
   Sie wollen den Wochentag des 24.~Dezembers~2027 wissen.
\begin{lstcode}
  Bitte zahlen Sie bis zum \ISODayName{2027-12-24}, 
  den 24.\,12.~2027, die Summe von \dots
\end{lstcode}
  Als Ergebnis erhalten Sie:
  \begin{ShowOutput}
  Bitte zahlen Sie bis zum 
  \ISODayName{2027-12-24}, den 
  24.\,12.~2027, die Summe von \dots
  \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 gehabt haben werden.
\begin{lstcode}
  In 12~Tagen haben wir einen 
  \DayName{\year}{\month}{\day+12} und
  24~Tage vor dem 24.~Dezember~2027 ist ein
  \ISODayName{2027-12-24-24}, wÃ¤hrend zwei Wochen 
  und drei Tage nach einem Mittwoch ein 
  \DayNameByNumber{3+2*7+3} folgt.
\end{lstcode}
  Als Ergebnis erhalten Sie beispielsweise:
  \begin{ShowOutput}
  In 12~Tagen haben wir einen 
  \DayName{\year}{\month}{\day+12} und
  24~Tage vor dem 24.~Dezember~2027 ist ein
  \ISODayName{2027-12-24-24}, wÃ¤hrend
  zwei Wochen und drei Tage nach
  einem Mittwoch ein \DayNameByNumber{3+2*7+3}
  folgt.
  \end{ShowOutput}
\end{Example}%
%
\EndIndexGroup
\ExampleEndFix


\begin{Declaration}
  \Macro{ISOToday}
  \Macro{IsoToday}
  \Macro{todaysname}
  \Macro{todaysnumber}
\end{Declaration}%
In den bisherigen Beispielen dieses Abschnitts wurde das aktuelle Datum immer
recht umstÃ¤ndlich Ã¼ber die \TeX-Register \Macro{year}\IndexCmd{year},
\Macro{month}\IndexCmd{month}, \Macro{day}\IndexCmd{day} bestimmt. Die
Anweisungen \Macro{ISOToday}\ChangedAt{v3.05a}{\Package{scrdate}} und
\Macro{IsoToday} liefern direkt das aktuelle Datum in ISO-Schreibweise. Sie
unterscheiden sich lediglich darin, dass \Macro{ISOToday} Monat und Tag immer
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.

\begin{Example}
  Ich will Ihnen zeigen, an was fÃ¼r einem Wochentag dieses Dokument gesetzt
  wurde. Dazu schreibe ich:
\begin{lstcode}
  Dieses Dokument entstand an einem \todaysname.
\end{lstcode}
  Das Ergebnis lautet:
  \begin{ShowOutput}
  Dieses Dokument entstand an einem \todaysname.
  \end{ShowOutput}
\end{Example}

\begin{Explain}
  Wenn\textnote{Tipp!} 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. Greifen Sie mit
\begin{lstcode}
  \MakeLowercase{\todaysname}
\end{lstcode}
  einfach auf die \LaTeX-Anweisung
  \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},
  \DescRef{scrdate.cmd.DayName}\IndexCmd{DayName} und
  \DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName}.%
\end{Explain}%
\EndIndexGroup


\begin{Declaration}
  \Macro{nameday}\Parameter{Name}
\end{Declaration}%
So wie mit \DescRef{maincls.cmd.date}\IndexCmd{date} die Ausgabe von
\Macro{today} direkt geÃ¤ndert werden kann, setzt \Macro{nameday} die Ausgabe
von \DescRef{scrdate.cmd.todaysname} auf den Wert \PName{Name}.
\begin{Example}
  Sie setzen mit \DescRef{maincls.cmd.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{lstcode}
  \nameday{Werktag}
\end{lstcode}
  und erhalten so mit dem Satz aus dem vorherigen Beispiel zu
  \DescRef{scrdate.cmd.todaysname}:
  \begin{ShowOutput}\nameday{Werktag}
    Dieses Dokument entstand an einem {\todaysname}.
  \end{ShowOutput}
\end{Example}
FÃ¼r \DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} und
\DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday} existieren keine
entsprechenden Anweisungen.%
\EndIndexGroup


\begin{Declaration}
  \Macro{newdaylanguage}\Parameter{Sprache}
                        \Parameter{Montag}\Parameter{Dienstag}
                        \Parameter{Mittwoch}\Parameter{Donnerstag}
                        \Parameter{Freitag}\Parameter{Samstag}
                        \Parameter{Sonntag}
\end{Declaration}
Das \Package{scrdate}-Paket beherrscht derzeit die folgenden Sprachen:
\begin{itemize}\raggedright\setlength{\itemsep}{.5\itemsep}
\item DÃ¤nisch (\PValue{danish}),
\item Deutsch (\PValue{austrian}\ChangedAt{v3.08b}{\Package{scrdate}},
  \PValue{german}, \PValue{naustrian}, \PValue{ngerman}, \PValue{nswissgerman},
  \PValue{swissgerman}\ChangedAt{v3.13}{\Package{scrdate}}),
\item Englisch (\PValue{american}\ChangedAt{v3.13}{\Package{scrdate}},
  \PValue{australian}, \PValue{british}, \PValue{canadian}, \PValue{english},
  \PValue{newzealand}, \PValue{UKenglish}, \PValue{ukenglish},
  \PValue{USenglish}, \PValue{usenglish}),
\item Finnisch (\PValue{finnish}),
\item FranzÃ¶sisch (\PValue{acadian}, \PValue{canadien},
  \PValue{francais}\ChangedAt{v3.13}{\Package{scrdate}}, \PValue{french}),
\item Italienisch (\PValue{italian}),
\item Kroatisch (\PValue{croatian}),
\item NiederlÃ¤ndisch (\PValue{dutch}),
\item Norwegisch (\PValue{norsk}),
\item Polnisch (\PValue{polish}\ChangedAt{v3.13}{\Package{scrdate}}),
\item Schwedisch (\PValue{swedish}),
\item Slowakisch (\PValue{slovak}),
\item Spanisch (\PValue{spanish}),
\item Tschechisch (\PValue{czech}\ChangedAt{v3.13}{\Package{scrdate}}).
\end{itemize}
Es kann aber auch fÃ¼r andere Sprachen konfiguriert werden. Dazu gibt man als
erstes Argument von \Macro{newdaylanguage} den Namen der Sprache an und als
weitere Parameter die Namen der entsprechenden Wochentage.

Bei der aktuellen Version ist es auch egal, ob \Package{scrdate} vor oder nach
\Package{ngerman}\IndexPackage{ngerman}, \Package{babel}\IndexPackage{babel}
oder Ã¤hnlichen Paketen geladen wird, in jedem Falle wird die korrekte Sprache
gewÃ¤hlt, vorausgesetzt diese wird unterstÃ¼tzt.

\begin{Explain}
  Etwas genauer ausgedrÃ¼ckt: Solange die Sprachauswahl in einer zu
  \Package{babel}\IndexPackage{babel} 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}

NatÃ¼rlich ist es sinnvoll Definitionen fÃ¼r bisher nicht unterstÃ¼tzte Sprachen
an den \KOMAScript-Autor zu melden. In diesem Fall stehen die Chancen gut,
dass kÃ¼nftige \KOMAScript-Versionen die Sprache ebenfalls unterstÃ¼tzen
werden.%
\EndIndexGroup
%
\EndIndexGroup


%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "scrguide-de.tex"
%%% coding: utf-8
%%% ispell-local-dictionary: "de_DE"
%%% eval: (flyspell-mode 1)
%%% End: 


%  LocalWords:  Gregorianischen ZÃ¤hlweise Ordnungszahl
</pre></body></html>