summaryrefslogtreecommitdiff
path: root/unused/newstrftime.3.txt
diff options
context:
space:
mode:
Diffstat (limited to 'unused/newstrftime.3.txt')
-rw-r--r--unused/newstrftime.3.txt149
1 files changed, 149 insertions, 0 deletions
diff --git a/unused/newstrftime.3.txt b/unused/newstrftime.3.txt
new file mode 100644
index 0000000000000..ea210a869f4a1
--- /dev/null
+++ b/unused/newstrftime.3.txt
@@ -0,0 +1,149 @@
+NAME
+
+ strftime - format date and time
+
+SYNOPSIS
+ #include <sys/types.h>
+ #include <time.h>
+
+ size_t strftime(buf, maxsize, format, timeptr)
+ char *buf;
+ size_t maxsize;
+ const char *format;
+ const struct tm *timeptr
+
+ cc ... -ltz
+
+DESCRIPTION
+ The strftime function formats the information from timeptr
+ into the buffer buf according to the string pointed to by
+ format.
+
+ The format string consists of zero or more conversion
+ specifications and ordinary characters. All ordinary
+ characters are copied directly into the buffer. A
+ conversion specification consists of a percent sign and one
+ other character.
+
+ No more than maxsize characters are be placed into the
+ array. If the total number of resulting characters,
+ including the terminating null character, is not more than
+ maxsize, strftime returns the number of characters in the
+ array, not counting the terminating null. Otherwise, zero
+ is returned.
+
+ Each conversion specification is replaced by the characters
+ as follows which are then copied into the buffer.
+
+ %A is replaced by the locale's full weekday name.
+
+ %a is replaced by the locale's abbreviated weekday name.
+
+ %B is replaced by the locale's full month name.
+
+ %b or %h
+ is replaced by the locale's abbreviated month name.
+
+ %C is replaced by the century (a year divided by 100 and
+ truncated to an integer) as a decimal number (00-99).
+
+ %c is replaced by the locale's appropriate date and time
+ representation.
+
+ %D is replaced by the date in the format %m/%d/%y.
+
+ %d is replaced by the day of the month as a decimal number
+ (01-31).
+
+ %e is replaced by the day of month as a decimal number
+ (1-31); single digits are preceded by a blank.
+ %F is replaced by the date in the format %Y-%m-%d.
+
+ %G is replaced by the ISO 8601 year with century as a
+ decimal number.
+
+ %g is replaced by the ISO 8601 year without century as a
+ decimal number (00-99).
+ %H is replaced by the hour (24-hour clock) as a decimal
+ number (00-23).
+
+ %I is replaced by the hour (12-hour clock) as a decimal
+ number (01-12).
+
+ %j is replaced by the day of the year as a decimal number
+ (001-366).
+
+ %k is replaced by the hour (24-hour clock) as a decimal
+ number (0-23); single digits are preceded by a blank.
+
+ %l is replaced by the hour (12-hour clock) as a decimal
+ number (1-12); single digits are preceded by a blank.
+
+ %M is replaced by the minute as a decimal number (00-59).
+
+ %m is replaced by the month as a decimal number (01-12).
+
+ %n is replaced by a newline.
+
+ %p is replaced by the locale's equivalent of either AM or
+ PM.
+
+ %R is replaced by the time in the format %H:%M.
+
+ %r is replaced by the locale's representation of 12-hour
+ clock time using AM/PM notation.
+
+ %S is replaced by the second as a decimal number (00-60).
+
+ %s is replaced by the number of seconds since the Epoch,
+ UTC (see mktime(3)).
+
+ %T is replaced by the time in the format %H:%M:%S.
+
+ %t is replaced by a tab.
+
+ %U is replaced by the week number of the year (Sunday as
+ the first day of the week) as a decimal number (00-53).
+
+ %u is replaced by the weekday (Monday as the first day of
+ the week) as a decimal number (1-7).
+
+ %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 1 has four or more days
+ in the new year, then it is week 1; otherwise it is
+ week 53 of the previous year, and the next week is week
+ 1.
+
+ %W is replaced by the week number of the year (Monday as
+ the first day of the week) as a decimal number (00-53).
+
+ %w is replaced by the weekday (Sunday as the first day of
+ the week) as a decimal number (0-6).
+
+ %X is replaced by the locale's appropriate time
+ representation.
+ %x is replaced by the locale's appropriate date
+ representation.
+
+ %Y is replaced by the year with century as a decimal
+ number.
+
+ %y is replaced by the year without century as a decimal
+ number (00-99).
+
+ %Z is replaced by the time zone name, or by the empty
+ string if this is not determinable.
+
+ %z is replaced by the offset from UTC in the format +HHMM
+ or -HHMM as appropriate, with positive values
+ representing locations east of Greenwich, or by the
+ empty string if this is not determinable.
+
+ %% is replaced by a single %.
+
+ %+ is replaced by the date and time in date(1) format.
+
+SEE ALSO
+ date(1), getenv(3), newctime(3), newtzset(3), time(2),
+ tzfile(5)