Loading...
stdtime/strftime.3 Libc-763.13 Libc-262.3.2
--- Libc/Libc-763.13/stdtime/strftime.3
+++ Libc/Libc-262.3.2/stdtime/strftime.3
@@ -13,6 +13,10 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by the University of
+.\"	California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
@@ -30,43 +34,27 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)strftime.3	8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/stdtime/strftime.3,v 1.40 2008/05/16 04:33:04 grog Exp $
-.\"
-.Dd November 4, 2004
+.\" $FreeBSD: src/lib/libc/stdtime/strftime.3,v 1.18.2.7 2001/12/14 18:33:59 ru Exp $
+.\"
+.Dd October 4, 1997
 .Dt STRFTIME 3
 .Os
 .Sh NAME
-.Nm strftime ,
-.Nm strftime_l
+.Nm strftime
 .Nd format date and time
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In time.h
 .Ft size_t
-.Fo strftime
-.Fa "char *restrict s"
-.Fa "size_t maxsize"
-.Fa "const char *restrict format"
-.Fa "const struct tm *restrict timeptr"
-.Fc
-.In time.h
-.In xlocale.h
-.Ft size_t
-.Fo strftime_l
-.Fa "char *restrict s"
-.Fa "size_t maxsize"
-.Fa "const char *restrict format"
-.Fa "const struct tm *restrict timeptr"
-.Fa "locale_t loc"
-.Fc
+.Fn strftime "char *buf" "size_t maxsize" "const char *format" "const struct tm *timeptr"
 .Sh DESCRIPTION
 The
 .Fn strftime
 function formats the information from
 .Fa timeptr
 into the buffer
-.Fa s ,
+.Fa buf
 according to the string pointed to by
 .Fa format .
 .Pp
@@ -88,15 +76,7 @@
 .Fn strftime
 returns the number of characters in the array, not counting the
 terminating NUL.
-Otherwise, zero is returned and the buffer contents are indeterminate.
-.Pp
-Although the
-.Fn strftime
-function uses the current locale, the
-.Fn strftime_l
-function may be passed a locale directly. See
-.Xr xlocale 3
-for more information.
+Otherwise, zero is returned and the buffer contents is indeterminate.
 .Pp
 The conversion specifications are copied to the buffer after expansion
 as follows:-
@@ -105,23 +85,31 @@
 is replaced by national representation of the full weekday name.
 .It Cm %a
 is replaced by national representation of
-the abbreviated weekday name.
+the abbreviated weekday name, where the abbreviation
+is the first three characters.
 .It Cm \&%B
 is replaced by national representation of the full month name.
 .It Cm %b
 is replaced by national representation of
-the abbreviated month name.
+the abbreviated month name, where the abbreviation is
+the first three characters.
 .It Cm \&%C
 is replaced by (year / 100) as decimal number; single
 digits are preceded by a zero.
 .It Cm %c
 is replaced by national representation of time and date.
+The format is similar to that produced by
+.Xr ctime 3
+and is
+equivalent to "%a %Ef %T %Y".
+It also implies the
+"3+1+6+1+8+1+4" format of output.
 .It Cm \&%D
 is equivalent to
 .Dq Li %m/%d/%y .
 .It Cm %d
 is replaced by the day of the month as a decimal number (01-31).
-.It Cm %E* %O*
+.It Cm \&%E* Cm \&%O*
 POSIX locale extensions.
 The sequences
 %Ec %EC %Ex %EX %Ey %EY
@@ -130,15 +118,14 @@
 are supposed to provide alternate
 representations.
 .Pp
-Additionally %OB implemented
-to represent alternative months names
+Additionly %Ef implemented to represent short month name / day
+order of the date, %EF to represent long month name / day
+order
+and %OB to represent alternative months names
 (used standalone, without day mentioned).
 .It Cm %e
-is replaced by the day of the month as a decimal number (1-31); single
+is replaced by the day of month as a decimal number (1-31); single
 digits are preceded by a blank.
-.It Cm \&%F
-is equivalent to
-.Dq Li %Y-%m-%d .
 .It Cm \&%G
 is replaced by a year as a decimal number with century.
 This year is the one that contains the greater part of
@@ -150,8 +137,7 @@
 .It Cm \&%H
 is replaced by the hour (24-hour clock) as a decimal number (00-23).
 .It Cm %h
-the same as
-.Cm %b .
+the same as %b.
 .It Cm \&%I
 is replaced by the hour (12-hour clock) as a decimal number (01-12).
 .It Cm %j
@@ -168,14 +154,13 @@
 is replaced by the month as a decimal number (01-12).
 .It Cm %n
 is replaced by a newline.
-.It Cm %O*
-the same as
-.Cm %E* .
+.It Cm \&%O*
+the same as %E*.
 .It Cm %p
 is replaced by national representation of either
-"ante meridiem" (a.m.)
+"ante meridiem"
 or
-"post meridiem" (p.m.)
+"post meridiem"
 as appropriate.
 .It Cm \&%R
 is equivalent to
@@ -201,8 +186,7 @@
 as a decimal number (1-7).
 .It Cm \&%V
 is replaced by the week number of the year (Monday as the first day of
-the week) as a decimal number (01-53).
-If the week containing January
+the week) as a decimal number (01-53).  If the week containing January
 1 has four or more days in the new year, then it is week 1; otherwise
 it is the last week of the previous year, and the next week is week 1.
 .It Cm %v
@@ -224,7 +208,7 @@
 is replaced by the year without century as a decimal number (00-99).
 .It Cm \&%Z
 is replaced by the time zone name.
-.It Cm %z
+.It Cm \&%z
 is replaced by the time zone offset from UTC; a leading plus sign stands for
 east of UTC, a minus sign for west of UTC, hours and minutes follow
 with two digits each and no delimiter between them (common form for
@@ -233,15 +217,6 @@
 is replaced by national representation of the date and time
 (the format is similar to that produced by
 .Xr date 1 ) .
-.It Cm %-*
-GNU libc extension.
-Do not do any padding when performing numerical outputs.
-.It Cm %_*
-GNU libc extension.
-Explicitly specify space for padding.
-.It Cm %0*
-GNU libc extension.
-Explicitly specify zero for padding.
 .It Cm %%
 is replaced by
 .Ql % .
@@ -251,9 +226,7 @@
 .Xr printf 1 ,
 .Xr ctime 3 ,
 .Xr printf 3 ,
-.Xr strptime 3 ,
-.Xr wcsftime 3 ,
-.Xr xlocale 3
+.Xr strptime 3
 .Sh STANDARDS
 The
 .Fn strftime
@@ -280,20 +253,13 @@
 .Ql %u ,
 .Ql \&%V ,
 .Ql %z ,
-and
 .Ql %+ .
 .Pp
 The peculiar week number and year in the replacements of
 .Ql %G ,
-.Ql %g ,
+.Ql %g
 and
 .Ql \&%V
 are defined in ISO 8601: 1988.
 .Sh BUGS
 There is no conversion specification for the phase of the moon.
-.Pp
-The
-.Fn strftime
-function does not correctly handle multibyte characters in the
-.Fa format
-argument.