summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/scrdatetime.tex
diff options
context:
space:
mode:
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.tex162
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: