aboutsummaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorTAMUKI Shoichi <tamuki@linet.gr.jp>2019-01-24 23:00:53 +0900
committerTAMUKI Shoichi <tamuki@linet.gr.jp>2019-01-24 23:00:53 +0900
commitb22eed371086b297adf9c1509850649de883d77b (patch)
tree4a834b782567b86e19bafb4ff0b9e1b7749bc0a1 /manual
parent3367acdb344a1d7fcf8f53748d301d652c8911dd (diff)
downloadglibc-b22eed371086b297adf9c1509850649de883d77b.zip
glibc-b22eed371086b297adf9c1509850649de883d77b.tar.gz
glibc-b22eed371086b297adf9c1509850649de883d77b.tar.bz2
strftime: Set the default width of "%Ey" to 2 [BZ #23758]
In Japanese locales, strftime's alternative year format (%Ey) produces a year numbered within a time period called an _era_. A new era typically begins when a new emperor is enthroned. The result of "%Ey" is therefore usually a one- or two-digit number. Many programs that display Japanese era dates assume that the era year is two digits wide. To improve how these programs display dates during the first nine years of a new era, change "%Ey" to pad one- digit numbers on the left with a zero. This change applies to all locales. It is expected to be harmless for other locales that use the alternative year format (e.g. lo_LA and th_TH, in which "%Ey" produces the year of the Buddhist calendar) as those calendars' year numbers are already more than two digits wide, and this is not expected to change. This change needs to be in place before 2019-05-01 CE, as a new era is scheduled to begin on that date. Reviewed-by: Zack Weinberg <zackw@panix.com> Reviewed-by: Rafal Luzynski <digitalfreak@lingonborough.com> ChangeLog: [BZ #23758] * manual/time.texi (strftime): Document "%Ey". * time/strftime_l.c (__strftime_internal): Set the default width padding with zero of "%Ey" to 2.
Diffstat (limited to 'manual')
-rw-r--r--manual/time.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/manual/time.texi b/manual/time.texi
index fd7781c..03a8a0e 100644
--- a/manual/time.texi
+++ b/manual/time.texi
@@ -1568,6 +1568,13 @@ The preferred time of day representation for the current locale.
The year without a century as a decimal number (range @code{00} through
@code{99}). This is equivalent to the year modulo 100.
+If the @code{E} modifier is specified (@code{%Ey}), instead produces
+the year number according to a locale-specific alternative calendar.
+Unlike @code{%y}, the number is @emph{not} reduced modulo 100.
+However, by default it is zero-padded to a minimum of two digits (this
+can be overridden by an explicit field width or by the @code{_} and
+@code{-} flags).
+
@item %Y
The year as a decimal number, using the Gregorian calendar. Years
before the year @code{1} are numbered @code{0}, @code{-1}, and so on.