diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex | 162 |
1 files changed, 83 insertions, 79 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex index 483c1a25349..1f9bdedb1e7 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex @@ -40,66 +40,71 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrpage2 in der KOMA-Script-Anleitung +% Kapitel über scrpage2 in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ -\ProvidesFile{scrdatetime.tex}[{2005/11/27 KOMA-Script guide (chapter: +\ProvidesFile{scrdatetime.tex}[{2007/09/26 KOMA-Script guide (chapter: scrdate, scrtime)}] +\translator{Gernot Hassenpflug\and Markus Kohm} + % Date of translated german file: 2005-11-27 -\chapter{Week-Day and Time Using \Package{scrdate} and \Package{scrtime}} +\chapter{Weekday and Time Using \Package{scrdate} and + \Package{scrtime}} \labelbase{datetime} -There are two packages at \KOMAScript{} to improve and extend the -handling of date\Index{date} and time\Index{time}. So you have not -only the standard commands \Macro{today} and \Macro{date}. Like all -the other packages from \KOMAScript{} bundle these two packages may be used -not only with \KOMAScript{} classes but also with standard and many -other classes. +There are two packages included in {\KOMAScript} to improve and extend +the handling of date\Index{date} and time\Index{time} over and above +what is provided by the standard commands \Macro{today} and +\Macro{date}. Like all the other packages from the {\KOMAScript} +bundle these two packages may be used not only with {\KOMAScript} +classes but also with the standard and many other classes. -\section{The Name of the Current Day of Week Using \Package{scrdate}} +\section{The Name of the Current Day of the Week Using + \Package{scrdate}} \label{sec:sec:datetime.scrdate} \BeginIndex{Package}{scrdate} -The first problem is the question about the current day of week. The answer -may be given by the package \Package{scrdate}. +The first problem is the question of the current day of the week. The +answer may be given using the package \Package{scrdate}. \begin{Declaration} \Macro{todaysname} \end{Declaration}% \BeginIndex{Cmd}{todaysname}% -You should know, that you may get the current date with -\Macro{today}\IndexCmd{today} in a language dependend -spelling. \Package{scrdate} offers you the command \Macro{todaysname}. This -results in the name of the current day of week in a language dependend +You should know that with \Macro{today}\IndexCmd{today} one obtains +the current date in a language-dependent spelling. \Package{scrdate} +offers you the command \Macro{todaysname} with which one can obtain +the name of the current day of the week in a language-dependent spelling. \begin{Example} - At your document you want to show the name of the week-day at which - the \File{dvi}-file was generated using \LaTeX. To do this, you + In your document you want to show the name of the weekday on which + the \File{dvi} file was generated using {\LaTeX}. To do this, you write: -\begin{lstlisting} - I've done the \LaTeX-run of this document on a \todaysname. -\end{lstlisting} - This will result in e.g.: + \begin{lstlisting} + I have done the {\LaTeX} run of this document on a \todaysname. + \end{lstlisting} + This will result in, e.\,g.: \begin{quote} - I've done the \LaTeX-run of this document on a \todaysname. + I have done the {\LaTeX} run of this document on a \todaysname. \end{quote} \end{Example} -Note that the package isn't able to decline. The known terms are the nominativ -singular that may be used e.g. at the date of a letter. For this the example -above is correct only at some languages. +Note that the package is not able to decline words. The known terms +are the nominative singular that may be used, e.\,g., in the date of a +letter. Given this limitation, the example above can work correctly +only for some languages. \begin{Explain} - \textbf{Tip:} The names of the week-days are saved in - capitalization. So the first letter is a capital letter, all the - others are small letters. But at some languages you also need the - names with a first letter in lower case. You may achieve this using - the standard \LaTeX{} command \Macro{MakeLowercase}. You simply have - to write \Macro{MakeLowercase}\PParameter{\Macro{todaysname}}. + \textbf{Tip:} The names of the weekdays are saved in capitalized + form, i.\,e., the first letter is a capital letter, all the others are + lowercase letters. But for some languages you may need the names + completely in lowercase. You may achieve this using the standard + {\LaTeX} command \Macro{MakeLowercase}. You simply have to write + \Macro{MakeLowercase}\PParameter{\Macro{todaysname}}. \end{Explain} \EndIndex{Cmd}{todaysname} @@ -107,43 +112,44 @@ above is correct only at some languages. \Macro{nameday}\Parameter{name} \end{Declaration}% \BeginIndex{Cmd}{nameday}% -You should know, that you may change the output of \Macro{today} using -\Macro{date}\IndexCmd{date}. In a analogous way you can change the -output of \Macro{todaysname} using \Macro{nameday} into \PName{name}. +Analogous to how the output of \Macro{today} can be modified using +\Macro{date}\IndexCmd{date}, so the output of \Macro{todaysname} can +be changed to \PName{name} by using \Macro{nameday}. \begin{Example} - You're changing the current date into a fix value using - \Macro{date}. You are not interested in the name of the day, but - you want to show, that it is a workday. So you set: + You change the current date to a fixed value using \Macro{date}. You + are not interested in the actual name of the day, but want only to + show that it is a workday. So you set: \begin{lstlisting} \nameday{workday} \end{lstlisting} After this the previous example will result in: \begin{quote} - I've done the \LaTeX-run of this document on a workday. + I have done the {\LaTeX} run of this document on a workday. \end{quote} \end{Example} \EndIndex{Cmd}{nameday} -Package \Package{scrdate} knows the languages english (english, american, -USenglish, UKenglish and british), german (german, ngerman and austrian), -french, italian, spanish, croatian, and finnish. If you want to configure it -for other languages, see \File{scrdate.dtx}. +Currently the package \Package{scrdate} knows the languages english +(english, american, USenglish, UKenglish and british), german (german, +ngerman and austrian), french, italian, spanish, croatian, and +finnish. If you want to configure it for other languages, see +\File{scrdate.dtx}. -At current implementation it doesn't matter, if you're loading +In the current implementation it does not matter whether you load \Package{scrdate} before or after \Package{german}\IndexPackage{german}, \Package{ngerman}\IndexPackage{ngerman}, \Package{babel}\IndexPackage{babel} or similar packages. The current -language will be setup at \Macro{begin}\PParameter{document}. +language will be set up at \Macro{begin}\PParameter{document}. \begin{Explain} - To explain it a little bit more exactly: While you are using a - language selection, which works in a compatible way to + To explain a little bit more exactly: while you are using a language + selection which works in a compatible way to \Package{babel}\IndexPackage{babel} or \Package{german}\IndexPackage{german}, the correct language will be used by \Package{scrdate}. If you are using another language - selection you will get english caption names. At \File{scrdate.dtx} - you will find the description of the \Package{scrdate}-commands for + selection you will get (US) english names. In \File{scrdate.dtx} you + will find the description of the \Package{scrdate} commands for defining the names. \end{Explain} \EndIndex{Package}{scrdate} @@ -153,39 +159,39 @@ language will be setup at \Macro{begin}\PParameter{document}. \label{sec:datetime.scrtime} \BeginIndex{Package}{scrtime} -The second problem is the question about current time. The solution may be -found using package \Package{scrtime}. +The second problem is the question of the current time. The solution +may be found using package \Package{scrtime}. \begin{Declaration}% \Macro{thistime}\OParameter{delimiter}\\ \Macro{thistime*}\OParameter{delimiter} \end{Declaration}% \BeginIndex{Cmd}{thistime}\BeginIndex{Cmd}{thistime*}% -\Macro{thistime} results in the current\Index{time}. -The delimiter between the values of hour and minute -can be given in the optional argument. -The default symbol of the delimiter is "\PValue{:}". - -\Macro{thistime*} works in the same way as \Macro{thistime}. -The difference between both is that the value of the minute -using \Macro{thistime*} is not preceded with zero when its value -is less than 10, thus using \Macro{thistime} the minute-value -has always two places. +\Macro{thistime} results in the current time\Index{time}. The +delimiter between the values of hour, minutes and seconds can be given +in the optional argument. The default symbol of the delimiter is +``\PValue{:}''. + +\Macro{thistime*} works in almost the same way as \Macro{thistime}. +The only difference is that unlike with \Macro{thistime}, with +\Macro{thistime*} the value of the minute field is not preceded by a +zero when its value is less than 10. Thus, with \Macro{thistime} the +minute field has always two places. \begin{Example} The line \begin{lstlisting} - Your train departs at \thistime . + Your train departs at \thistime. \end{lstlisting} - results for example in: + results, for example, in: \begin{quote} - Your train departs at \thistime . + Your train departs at \thistime. \end{quote} or: \begin{quote} Your train departs at 23:09. \end{quote} \bigskip - In contrast to the prevous example a line like: + In contrast to the previous example a line like: \begin{lstlisting} This day is already \thistime*[\ hours and\ ] minutes old. \end{lstlisting} @@ -201,15 +207,14 @@ has always two places. \EndIndex{Cmd}{thistime}\EndIndex{Cmd}{thistime*} \begin{Declaration}% - \Macro{settime}\Parameter{Time} + \Macro{settime}\Parameter{time} \end{Declaration}% \BeginIndex{Cmd}{settime}% -\Macro{settime} sets the output \Macro{thistime} and -\Macro{thistime*} on the value of \PName{Time}. -Afterwards the optinal parameter of \Macro{thistime} or -\Macro{thistime*} is ignored, since the result -of \Macro{thistime} or \Macro{thistime*} -was completely determined using \Macro{settime}.% +\Macro{settime} sets the output of \Macro{thistime} and +\Macro{thistime*} to the value \PName{time}. Now the optional +parameter of \Macro{thistime} or \Macro{thistime*} is ignored, since +the result of \Macro{thistime} or \Macro{thistime*} was completely +determined using \Macro{settime}.% \EndIndex{Cmd}{settime} \begin{Declaration} @@ -217,17 +222,16 @@ was completely determined using \Macro{settime}.% \Option{24h} \end{Declaration}% \BeginIndex{Option}{12h}\BeginIndex{Option}{24h}% -Using the options \Option{12h} and \Option{24h} one can -select whether the result of \Macro{thistime} and \Macro{thistime*} -is in 12- or in 24-hour format. The default is \Option{24h}.% - -The option has no effect on the results of -\Macro{thistime} and \Macro{thistime*} if \Macro{settime} -has been used.% +Using the options \Option{12h} and \Option{24h} one can select whether +the result of \Macro{thistime} and \Macro{thistime*} is in 12- or in +24-hour format. The default is \Option{24h}. The option has no effect +on the results of \Macro{thistime} and \Macro{thistime*} if +\Macro{settime} is used.% \EndIndex{Option}{12h}\EndIndex{Option}{24h} \EndIndex{Package}{scrtime} %%% Local Variables: %%% mode: latex +%%% coding: iso-latin-1 %%% TeX-master: "../guide" %%% End: |