LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

strftime.3: Expand %E and %O description 

* man3/strftime.3 (%C): Describe the meaning of %EC conversion
specification.
(%E): Mention the concept of "era" in description.
(%O): Mention that alternative format is related to numeric
representation.
(%y): Describe the meaning of %Ey conversion specification.
(%Y): Describe the meaning of %EY conversion specification.
(.SH DESCRIPTION): Mention that the behaviour of %E modifier is governed
by ERA locale element and provide ja_JP locale as an example.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Eugene Syromyatnikov 2020-02-14 16:29:05 +01:00 committed by Michael Kerrisk
parent 3b9cbcdc61
commit b0f9cb5e85
1 changed files with 26 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
man3/strftime.3
View File

@ -143,6 +143,9 @@ conversion specification.)
.TP
.B %C
The century number (year/100) as a 2-digit integer. (SU)
(The
.B %EC
conversion specification corresponds to the name of the era.)
(Calculated from
.IR tm_year .)
.TP
@ -170,7 +173,7 @@ zero is replaced by a space. (SU)
.IR tm_mday .)
.TP
.B %E
Modifier: use alternative format, see below. (SU)
Modifier: use alternative ("era-based") format, see below. (SU)
.TP
.B %F
Equivalent to
@ -253,7 +256,7 @@ The minute as a decimal number (range 00 to 59).
A newline character. (SU)
.TP
.B %O
Modifier: use alternative format, see below. (SU)
Modifier: use alternative numeric symbols, see below. (SU)
.TP
.B %p
Either "AM" or "PM" according to the given time value, or the
@ -400,11 +403,20 @@ conversion specification.)
.TP
.B %y
The year as a decimal number without a century (range 00 to 99).
(The
.B %Ey
conversion specification corresponds to the year since the beginning of the era
denoted by
.B %EC
conversion specification.)
(Calculated from
.IR tm_year )
.TP
.B %Y
The year as a decimal number including the century.
(The
.B %EY
conversion specification corresponds to the full alternative year representation.)
(Calculated from
.IR tm_year )
.TP
@ -463,7 +475,18 @@ where the effect of the
.B O
modifier is to use
alternative numeric symbols (say, roman numerals), and that of the
E modifier is to use a locale-dependent alternative representation.
.B E
modifier is to use a locale-dependent alternative representation.
The rules governing date representation with the
.B E
modifier can be obtained by supplying
.B ERA
as an argument to a
.BR nl_langinfo (3)
library call.
One example of such alternative forms is Japanese era calendar scheme in the
.B ja_JP
glibc locale.
.SH RETURN VALUE
Provided that the result string,
including the terminating null byte, does not exceed