diff options
Diffstat (limited to 'manual/time.texi')
| -rw-r--r-- | manual/time.texi | 92 |
1 files changed, 88 insertions, 4 deletions
diff --git a/manual/time.texi b/manual/time.texi index c8ca7e8118..f439840170 100644 --- a/manual/time.texi +++ b/manual/time.texi @@ -624,7 +624,20 @@ time conversion (@pxref{Locales}). Ordinary characters appearing in the @var{template} are copied to the output string @var{s}; this can include multibyte character sequences. -Conversion specifiers are introduced by a @samp{%} character, and are +Conversion specifiers are introduced by a @samp{%} character. Now can +follow an optional flag which can be one of the following. These flags +only affect the output of numbers: + +@table @code +@item _ +The number is padded with spaces. + +@item - +The number is not padded at all. +@end table + +The default action is to pad the number with zeros. Following to the +flag comes the format specifier. The whole @samp{%} sequence is replaced in the output string as follows: @table @code @@ -643,9 +656,29 @@ The full month name according to the current locale. @item %c The preferred date and time representation for the current locale. +@item %C +The century of the year. + @item %d The day of the month as a decimal number (range @code{01} to @code{31}). +@item %D +The date using the format @code{%m/%d/%y}. + +This format is a GNU extension. + +@item %d +The day of the month like with @code{%d}, but padded with blank (range +@code{ 1} to @code{31}). + +This format is a GNU extension. + +@item %h +The abbreviated month name according to the current locale. The action +is the same as for @code{%b}. + +This format is a GNU extension. + @item %H The hour as a decimal number, using a 24-hour clock (range @code{00} to @code{23}). @@ -657,19 +690,64 @@ The hour as a decimal number, using a 12-hour clock (range @code{01} to @item %j The day of the year as a decimal number (range @code{001} to @code{366}). +@item %k +The hour as a decimal number, using a 24-hour clock like @code{%H}, but +padded with blank (range @code{ 0} to @code{23}). + +This format is a GNU extension. + +@item %l +The hour as a decimal number, using a 12-hour clock like @code{%I}, but +padded with blank (range @code{ 0} to @code{12}). + +This format is a GNU extension. + @item %m The month as a decimal number (range @code{01} to @code{12}). @item %M The minute as a decimal number. +@item %n +A single @samp{\n} (newline) character. + +This format is a GNU extension. + @item %p Either @samp{am} or @samp{pm}, according to the given time value; or the corresponding strings for the current locale. +@item %r +The time in decinal numbers using the format @code{%I:%M:%S %p}. + +This format is a GNU extension. + +@item %R +The hour and minute in decimal numbers using the format @code{%H:%M}. + +This format is a GNU extension. + +@item %s +The seconds since the epoch, i.e., 1 January 1970 00:00:00 UTC. Note +that this value is the number of seconds between the epoch and the +current date as defined by the @code{localtime} system call. It is not +changed by the @code{--date} option. + +This format is a GNU extension. + @item %S The second as a decimal number. +@item %t +A single @samp{\t} (tabulator) character. + +This format is a GNU extension. + +@item %T +The time using decimal numbers using the format @code{%H:%M:%S}. + +This format is a GNU extension. + @item %U The week number of the current year as a decimal number, starting with the first Sunday as the first day of the first week. All days preceding @@ -682,14 +760,14 @@ containing January 1 has four or more days in the new year it is considered to be week @code{1}. Otherwise it is week @code{53} of the previous year. This is standardized in @w{ISO 8601:1988}. +@item %w +The day of the week as a decimal number, Sunday being @code{0}. + @item %W The week number of the current year as a decimal number, starting with the first Monday as the first day of the first week. All days preceding the first Monday in the year are considered to be in week @code{0}. -@item %w -The day of the week as a decimal number, Sunday being @code{0}. - @item %x The preferred date representation for the current locale, but without the time. @@ -704,6 +782,12 @@ The year as a decimal number, but without a century (range @code{00} to @item %Y The year as a decimal number, including the century. +@item %z +@w{RFC 822}/@w{ISO 8601:1988} style numeric time zone (e.g., -0600 or ++0100), or nothing if no time zone is determinable. This value reflects +the @emph{current} time zone. It is not changed by the @code{--date} +option. + @item %Z The time zone or name or abbreviation (empty if the time zone can't be determined). |