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.tex346
1 files changed, 173 insertions, 173 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 2cd16e0229d..7acd9f2bf79 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
@@ -1,6 +1,6 @@
% ======================================================================
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,52 +46,53 @@
% ============================================================================
\KOMAProvidesFile{scrdatetime.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (chapter: scrdate, scrtime)]
-\translator{Markus Kohm\and Gernot Hassenpflug}
+\translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-02-05
-\chapter{The Day of the Week Using \Package{scrdate}}
+\chapter{The Day of the Week with \Package{scrdate}}
\labelbase{scrdate}
\BeginIndexGroup
\BeginIndex{Package}{scrdate}
-With version~3.05a the functionality of this package enhanced a lot. Beside of
-the current day of the week\Index{day>of the week} this package provides the
-day of the week of every date of the Gregorian calendar now.
+Originally, the \Package{scrdate} package could only give the day of the week
+for the current date. Nowadays, it offers this and more for any date in the
+Gregorian calendar.
\begin{Declaration}
\Macro{CenturyPart}\Parameter{year}\\%
\Macro{DecadePart}\Parameter{year}%
\end{Declaration}%
-The\ChangedAt{v3.05a}{\Package{scrdate}} command \Macro{CenturyPart} offers
-the value of the century digits\,---\,hundreds and thousands\,---\,of a
-\PName{year}. The command \Macro{DecadePart} in difference offers the other
-digits which are the units and tens. The number of digits of \PName{year} does
-not care. The value may be assigned to a counter or may be used for
-calculations, i.\,e., using \Macro{numexpr}\IndexCmd{numexpr}. For
-output\textnote{Attention!} of an Arabic number of the value prefix it with
-\Macro{the}\IndexCmd{the}.
+The\ChangedAt{v3.05a}{\Package{scrdate}} \Macro{CenturyPart} command returns
+the value of the century digits\,---\,thousands and hundreds\,---\,of a
+\PName{year}. The \Macro{DecadePart} command, on the other hand, gives the
+value of the remaining digits, i.\,e. the tens and the units. The
+\PName{year} can have any number of digits. You can assign the value directly
+to a counter or use it for calculations with
+\Macro{numexpr}\IndexCmd{numexpr}. To output\textnote{Attention!} it as an
+Arabic number, you should prefix it with \Macro{the}\IndexCmd{the}.
\begin{Example}
- You want to calculate and output the century of the current year.
+ You want to calculate and print the century of the current year.
\begin{lstcode}
- The year \the\year\ is the year \the\DecadePart{\year}
+ The year \the\year\ is year \the\DecadePart{\year}
of the \engord{\numexpr\CenturyPart{\year}+1\relax} century.
\end{lstcode}
The result would be:
\begin{quote}
- The year \the\year\ is the year \the\DecadePart{\year}
+ The year \the\year\ is year \the\DecadePart{\year}
of the \engordnumber{\numexpr\CenturyPart{\year}+1\relax} century.
\end{quote}
- Package \Package{engord}\IndexPackage{engord} has been used for this
- example. See \cite{package:engord} for more information.
+ This example uses the \Package{engord}\IndexPackage{engord} package.
+ See \cite{package:engord} for more information.
\end{Example}
-Please\textnote{Attention!} note, that within used method of counting the
-year~2000 is the year~0\,---\,and therefore the first year\,---\,of the
-21st~century.%
+Note\textnote{Attention!} that the counting method used here treats the year
+2000 as year~0\,---\,and therefore the first year\,---\,of the 21st~century.
+If necessary, however, you can make a correction with \Macro{numexpr}, as
+shown for the ordinal number in the example.%
\EndIndexGroup
@@ -99,17 +100,17 @@ year~2000 is the year~0\,---\,and therefore the first year\,---\,of the
\Macro{DayNumber}\Parameter{year}\Parameter{month}\Parameter{day}\\%
\Macro{ISODayNumber}\Parameter{ISO-date}%
\end{Declaration}%
-These\ChangedAt{v3.05a}{\Package{scrdate}} two commands offers the value of
-the number of the day of the week\Index{day>of the week} of any date. The
-differ only in the kind of date declaration. Command \Macro{DayNumber} needs
-\PName{year}, \PName{month}, and \PName{day} as separate parameters. Command
-\Macro{ISODayNumber} expects an \PName{ISO-date} as a single argument. The
-expected format of the \PName{ISO-date} is:
+These\ChangedAt{v3.05a}{\Package{scrdate}} two commands return the value of
+the day-of-the-week\Index{day>of the week} number for any date. They differ
+only in the method of specifying the date. While the \Macro{DayNumber} command
+requires the \PName{year}, \PName{month}, and \PName{day} as separate
+parameters, the \Macro{ISODayNumber} command expects an \PName{ISO-date} as a
+single argument, \PName{ISO-date}, using the ISO notation
\PName{year}\texttt{-}\PName{month}\texttt{-}\PName{day}. It does not matter
-whether \PName{month} or \PName{day} have one or two digits. The result of
-both commands may be assigned to a counter or used for calculations, i.\,e.,
-using \Macro{numexpr}\IndexCmd{numexpr}. For output\textnote{Attention!} of an
-Arabic number of the value prefix it with \Macro{the}\IndexCmd{the}.
+if the \PName{month} or \PName{day} have one or two digits. You can use the
+result of both commands to assign directly to a counter or for calculations
+using \Macro{numexpr}\IndexCmd{numexpr}. To print\textnote{Attention!} it as
+an Arabic number, you should prefix it with \Macro{the}\IndexCmd{the}.
\begin{Example}
You want to know the number of the day of the week of the 1st~May~2027.
@@ -124,28 +125,29 @@ Arabic number of the value prefix it with \Macro{the}\IndexCmd{the}.
\end{quote}
\end{Example}
-A special feature is to walk a number of days into future or past from a given
-date.
+It is particularly worth noting that you can even step a specified number of
+days into the future or or the past from a given date.
\begin{Example}
- You want to know the number of the day of the week, that will be in 12~days
- and that will be 24~days before the 24th~December~2027.
+ You want to know the number of the day of the week 12~days from now
+ and 24~days before the 24th~December~2027.
\begin{lstcode}
- In 12~days the number of the day of the week
- will be \the\DayNumber{\year}{\month}{\day+12} and
+ In 12~days, the number of the day of the week
+ will be \the\DayNumber{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
\the\ISODayNumber{2027-12-24-24}.
\end{lstcode}
- The result may be, e.\,g.:
+ The result could be, for example:
\begin{quote}
- In 12~days the number of the day of the week
- will be \the\DayNumber{\year}{\month}{\day+12} and
+ In 12~days, the number of the day of the week
+ will be \the\DayNumber{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
\the\ISODayNumber{2027-12-24-24}.
\end{quote}
\end{Example}
-The days of the week are numbered: Sunday\,=\,0, Monday\,=\,1, Tuesday\,=\,2,
-Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and Saturday\,=\,6.%
+The days of the week are numbered as follows: Sunday\,=\,0, Monday\,=\,1,
+Tuesday\,=\,2, Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and
+Saturday\,=\,6.%
%
\EndIndexGroup
@@ -155,48 +157,48 @@ Wednesday\,=\,3, Thursday\,=\,4, Friday\,=\,5, and Saturday\,=\,6.%
\Macro{DayName}\Parameter{year}\Parameter{month}\Parameter{day}\\%
\Macro{ISODayName}\Parameter{ISO-date}%
\end{Declaration}%
-Usually\ChangedAt{v3.05a}{\Package{scrdate}} you do not want to know the number
-of the day of the week, but the name of the day of the week. Because of this,
-the command \Macro{DayNameByNumber} offers the name of the day of the week
-corresponding with a number. The number may be the result of \Macro{DayNumber}
-or \Macro{ISODayNumber}. The two commands \Macro{DayName} and
-\Macro{ISODayName} directly offer the name of the day of the week of a given
-date.
+Usually\ChangedAt{v3.05a}{\Package{scrdate}} you are less interested in the
+number of the day of the week than in its name. Therefore, the
+\Macro{DayNameByNumber} command returns the name of the day of the week
+corresponding to a day-of-the-week number. This number can be the result, for
+example, of \Macro{DayNumber} or \Macro{ISODayNumber}. The two commands
+\Macro{DayName} and \Macro{ISODayName} directly return the name of the day of
+the week of a given date.
\begin{Example}
You want to know the name of the day of the week of the 24th~December~2027.
\begin{lstcode}
- Please pay you bill until \ISODayName{2027-12-24},
- 24th~December~2027.
+ Please pay by \ISODayName{2027-12-24},
+ 24th~December~2027 the amount of \dots.
\end{lstcode}
The result will be:
\begin{quote}
- Please pay you bill until \ISODayName{2027-12-24},
- 24th~December~2027.
+ Please pay by \ISODayName{2027-12-24},
+ 24th~December~2027 the amount of \dots.
\end{quote}
\end{Example}
-Again a special feature is to make some calculations inside the argument of
-\Macro{DayName}.
+Once again, it is particularly worth noting that you can perform calculations,
+to a certain extent:
\begin{Example}
- You want to know the names of the days of the week, that will be in 12~days
- and that will be 24~days before the 24th~December~2027.
+ You want to know the names of the day of the week 12~days from now
+ and 24~days before the 24th~December~2027.
\begin{lstcode}
- In 12~days the name of the day of the week
- will be \DayName{\year}{\month}{\day+12} and
+ In 12~days, the name of the day of the week
+ will be \DayName{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
- \ISODayName{2027-12-24-24}. Nevertheless two weeks
- and three days after a Wednesday a
- \DayNameByNumber{3+2*7+3} will follow.
+ \ISODayName{2027-12-24-24}, while two weeks
+ and three days after a Wednesday will be a
+ \DayNameByNumber{3+2*7+3}.
\end{lstcode}
- The result may be, e.\,g.:
+ The result could be, for example:
\begin{quote}
- In 12~days the name of the day of the week
- will be \DayName{\year}{\month}{\day+12} and
+ In 12~days, the name of the day of the week
+ will be \DayName{\year}{\month}{\day+12}, and
24~days before the 24th~December~2027 it will be
- \ISODayName{2027-12-24-24}. Nevertheless two weeks
- and three days after a Wednesday a
- \DayNameByNumber{3+2*7+3} will follow.
+ \ISODayName{2027-12-24-24}, while two weeks
+ and three days after a Wednesday will be a
+ \DayNameByNumber{3+2*7+3}.
\end{quote}
\end{Example}%
%
@@ -209,54 +211,52 @@ Again a special feature is to make some calculations inside the argument of
\Macro{todaysname}%
\Macro{todaysnumber}%
\end{Declaration}%
-In the prior examples the current date have been given cumbersomely and
-explicitly using the \TeX{} registers \Macro{year}\IndexCmd{year},
-\Macro{month}\IndexCmd{month}, and \Macro{day}\IndexCmd{day}. The commands
+In the previous examples, the current date was always specified cumbersomely
+using the \TeX{} registers \Macro{year}\IndexCmd{year},
+\Macro{month}\IndexCmd{month}, and \Macro{day}\IndexCmd{day}. The
\Macro{ISOToday}\ChangedAt{v3.05a}{\Package{scrdate}} and \Macro{IsoToday}
-offers the current date in ISO-notation directly. These commands differ in the
-number of digits for numbers less than 10 only. \Macro{ISOToday} prefixes
-numbers less than 10 for the month and day with a 0. In opposite to this
-\Macro{IsoToday} will show numbers less than 10 for the month and day with one
-digit only. Command \Macro{todaysname} directly offers the name of the current
-day of the week. Command \Macro{todaysnumber} offers the number of that name
-instead. More information about usability of this value may be found at
-previous description of \DescRef{scrdate.cmd.DayNumber} and \DescRef{scrdate.cmd.ISODayNumber}.
+commands directly return the current date in ISO-notation. These commands
+differ only in the fact that \Macro{ISOToday} always outputs a two-digit month
+and day, while \Macro{IsoToday} outputs single-digit numbers for values less
+than 10. The \Macro{todaysname} command directly returns the name of the
+current day of the week, while \Macro{todaysnumber} returns the number of the
+current day of the week. You can find more information about using this value
+in the explanations of \DescRef{scrdate.cmd.DayNumber} and
+\DescRef{scrdate.cmd.ISODayNumber}.
\begin{Example}
- I want to show you the name of the weekday in which this document has been
- type-set:
- \begin{lstlisting}
- I have done the {\LaTeX} run of this document
- on a \todaysname.
- \end{lstlisting}
- This will result in, e.\,g.:
+ I want to show you on what day of the week this document was typeset:
+\begin{lstlisting}
+ This document was created on a \todaysname.
+\end{lstlisting}
+ This will result, for example, in:
\begin{quote}
- I have done the {\LaTeX} run of this document
- on a \todaysname.
+ This document was created on a \todaysname.
\end{quote}
\end{Example}
-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.
+For languages that have a case system for nouns, note that the package cannot
+decline words. The terms are given in the form appropriate for displaying a
+date in a letter, which is the nominative singular for the currently supported
+languages. Given this limitation, the example above will not work correctly if
+translated directly into some other languages.
\begin{Explain}
- The\textnote{Hint!} 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}\IndexCmd{MakeLowercase}%
- \important{\Macro{MakeLowercase}}, e.\,g.:
+ The\textnote{Hint!} names of the weekdays in \Package{scrdate} all have
+ initial capital letters. If you need the names completely in lower case, for
+ example because that is the convention in the relevant language, simply wrap
+ the command with the \LaTeX{} \Macro{MakeLowercase}\IndexCmd{MakeLowercase}%
+ \important{\Macro{MakeLowercase}} command:
% Umbruchkorrektur: listings
\begin{lstcode}
\MakeLowercase{\todaysname}
\end{lstcode}
- This converts the whole argument into lower case letters. Of course, this
- may be done also using previous described commands
+ This converts the whole argument into lower-case letters. Of course, you can
+ also do this for
\DescRef{scrdate.cmd.DayNameByNumber}\IndexCmd{DayNameByNumber},
- \DescRef{scrdate.cmd.DayName}\IndexCmd{DayName} and
- \DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName}.%
+ \DescRef{scrdate.cmd.DayName}\IndexCmd{DayName}, and
+ \DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName} commands described
+ above.%
\end{Explain}%
\EndIndexGroup
@@ -264,23 +264,24 @@ only for some languages.
\begin{Declaration}
\Macro{nameday}\Parameter{name}
\end{Declaration}%
-Analogous to how the output of \Macro{today} can be modified using
-\DescRef{maincls.cmd.date}\IndexCmd{date}, so the output of \DescRef{scrdate.cmd.todaysname}
-can be changed to \PName{name} by using \Macro{nameday}.
+Just as you can directly modify the output of \Macro{today} with
+\DescRef{maincls.cmd.date}\IndexCmd{date}, so you can change the output of
+\DescRef{scrdate.cmd.todaysname} to \PName{name} with \Macro{nameday}.
\begin{Example}
You change the current date to a fixed value using
- \DescRef{maincls.cmd.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:
+ \DescRef{maincls.cmd.date}. You are not interested in the actual name of the
+ day, but want only to show that it is a workday. So you write:
\begin{lstlisting}
\nameday{workday}
\end{lstlisting}
- After this the previous example will result in:
+ After this, the previous example will result in:
\begin{quote}\nameday{workday}
- I have done the {\LaTeX} run of this document on a \todaysname.
+ This document was created on a \todaysname.
\end{quote}
\end{Example}
-There's no such command for changing the result of
-\DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} or \DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday}.
+There's no corresponding command to change the result of
+\DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} or
+\DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday}.%
\EndIndexGroup
@@ -291,7 +292,7 @@ There's no such command for changing the result of
\Parameter{Friday}\Parameter{Saturday}
\Parameter{Sunday}%
\end{Declaration}
-Currently the package \Package{scrdate} knows the following languages:
+Currently the \Package{scrdate} package recognizes the following languages:
\begin{itemize}\setlength{\itemsep}{.5\itemsep}
\item Croatian (\PValue{croatian}),
\item Czech (\PValue{czech}\ChangedAt{v3.13}{\Package{scrdate}}),
@@ -310,61 +311,57 @@ Currently the package \Package{scrdate} knows the following languages:
\item Italian (\PValue{italian}),
\item Norwegian (\PValue{norsk}),
\item Polish (\PValue{polish}\ChangedAt{v3.13}{\Package{scrdate}}),
+\item Slovak (\PValue{slovak}),
\item Spanish (\PValue{spanish}),
\item Swedish (\PValue{swedish}).
\end{itemize}
-If you want to configure it for other languages, you may use this command. The
-first argument is the name of the language and the other arguments are the
-names of the corresponding days.
+You can also configure it for additional languages. To do so, the first
+argument of \Macro{newdaylanguage} is the name of the language, and the other
+arguments are the names of the corresponding days of the week.
-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. In both cases the
-correct language will be used.
+In the current implementation, it does not matter whether you load
+\Package{scrdate} before or after \Package{ngerman}\IndexPackage{ngerman},
+\Package{babel}\IndexPackage{babel}, or similar packages. In each case the
+correct language will be used provided it is supported.
\begin{Explain}
- 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{ngerman}\IndexPackage{ngerman}, the correct language will be used
- by \Package{scrdate}. If you are using another language selection you will
- get (US-)English names.
+ To be more precise, as long as you select a language in a way that is
+ compatible with \Package{babel}\IndexPackage{babel}, \Package{scrdate} will
+ use the correct language. If this is not the case, you will get (US) English
+ names.
\end{Explain}
-By the way: If you found a suitable definition for a language, that has not
-been defined before, please mail it to the \KOMAScript{} author. There is a
-good chance, that he will add support for the language to \Package{scrdate}.%
+Of course, if you create definitions for a language that was previously
+unsupported, please mail them to the author of \KOMAScript{}. There is a good
+chance that future versions of \KOMAScript{} will add support for that
+language.%
\EndIndexGroup
%
\EndIndexGroup
-\chapter{Getting the Time with Package \Package{scrtime}}
+\chapter{The Current Time with \Package{scrtime}}
\labelbase{scrtime}
\BeginIndexGroup
\BeginIndex{Package}{scrtime}
-This package provides an answer to the question of the current time. Since
-version~3.05 this package uses the option interface already known from
-the \KOMAScript{} classes and several other \KOMAScript{} packages. See for
-example \autoref{sec:typearea.options} for more information.
+This package lets you find the current time. Starting with version~3.05, the
+package also supports the option interface already familiar from the
+\KOMAScript{} classes and various other \KOMAScript{} packages. See, for
+example, \autoref{sec:typearea.options} for more information.
\begin{Declaration}%
\Macro{thistime}\OParameter{delimiter}%
\Macro{thistime*}\OParameter{delimiter}
\end{Declaration}%
-\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.
+\Macro{thistime} returns the current time\Index{time} in hours and minutes.
+The delimiter between the values of hour, minutes and seconds can be given in
+the optional argument. The default is the character ``\PValue{:}''.
+
+\Macro{thistime*} works in almost the same way as \Macro{thistime}. The only
+difference is that, unlike \Macro{thistime}, \Macro{thistime*} does not add a
+leading zero to the minute field when its value is less than 10. Thus, with
+\Macro{thistime} the minute field has always two places.
\begin{Example}
The line
\begin{lstlisting}
@@ -399,37 +396,40 @@ minute field has always two places.
\Macro{settime}\Parameter{time}
\end{Declaration}%
\Macro{settime} sets the output of \DescRef{scrtime.cmd.thistime} and
-\DescRef{scrtime.cmd.thistime*} to the value \PName{time}. Now the optional
-parameter of \DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*} is ignored, since
-the result of \DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*} was completely
-determined using \Macro{settime}.%
+\DescRef{scrtime.cmd.thistime*} to a fixed value. In this case, the optional
+parameter of \DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*}
+is ignored, since the complete string returned by
+\DescRef{scrtime.cmd.thistime} or \DescRef{scrtime.cmd.thistime*} has been
+explicitly defined. \Macro{settime}.%
\EndIndexGroup
\begin{Declaration}
- \OptionVName{12h}{simple-switch}%
+ \OptionVName{12h}{simple switch}%
\end{Declaration}%
\BeginIndex{Option}{24h}%
-With option \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} one can select
-whether the result of \DescRef{scrtime.cmd.thistime} and \DescRef{scrtime.cmd.thistime*} is in 12- or in
-24-hour format. The option understands the values for simple-switch listed in
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The option
-without a value is same like \OptionValue{12h}{true} and therefore
-12-hour-format will be used. The default is \Option{24h}.
-
-You may use this option either as a global option in the optional argument of
+With the \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} option, you can
+select whether to print the time given by \DescRef{scrtime.cmd.thistime} and
+\DescRef{scrtime.cmd.thistime*} in 12- or 24-hour format. The option accepts
+the values for simple switches listed in \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch}. Using the option without a value is
+equivalent to \OptionValue{12h}{true}, and therefore activates the
+12-hour-format. The default, however, is \Option{24h}.
+
+You can set this option globally in the optional argument of
\DescRef{typearea.cmd.documentclass}, as a package option in the optional
-argument of \DescRef{typearea.cmd.usepackage} or after loading the package
-using \DescRef{typearea.cmd.KOMAoptions} or \DescRef{typearea.cmd.KOMAoption}
-(see, e.\,g., \autoref{sec:typearea.options},
-\DescPageRef{typearea.cmd.KOMAoptions}). The option has no effect on the
-results of \DescRef{scrtime.cmd.thistime} and \DescRef{scrtime.cmd.thistime*}
-if \DescRef{scrtime.cmd.settime} is used.
-
-Only\textnote{Attention!} for compatibility with former releases of
-\Package{scrtime} also option \Option{24h} will switch to 24-hour format if
-used in the optional argument of \Macro{documentclass} or
-\Macro{usepackage}. Nevertheless, you should not use this option any longer.%
+argument of \DescRef{typearea.cmd.usepackage}, or even after loading the
+package using \DescRef{typearea.cmd.KOMAoptions} or
+\DescRef{typearea.cmd.KOMAoption} (see, e.\,g. \autoref{sec:typearea.options},
+\DescPageRef{typearea.cmd.KOMAoptions}). However the option no longer has any
+effect on the if you call \DescRef{scrtime.cmd.settime}. After invoking this
+command, the time is output only with the value and in the format specified
+there.
+
+For\textnote{Attention!} the sake of compatibility with earlier versions of
+\Package{scrtime}, the option \Option{24h} will switch to 24-hour format if
+used in the optional argument of \Macro{documentclass} or \Macro{usepackage}.
+However, you should not use this option any longer.%
\EndIndexGroup
%
\EndIndexGroup