<TITLE>strftime</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>
<h3>STRFTIME(3) Linux Programmer's Manual STRFTIME(3)
</h3>
<h3>NAME
</h3> strftime - format date and time
<h3>SYNOPSIS
</h3> #include <time.h>
size_t strftime(char *s, size_t max, const char *format,
const struct tm *tm);
<h3>DESCRIPTION
</h3> The strftime() function formats the broken-down time tm
according to the format specification format and places
the result in the character array s of size max.
Ordinary characters placed in the format string are copied
to s without conversion. Conversion specifiers are intro-
duced by a `%' character, and are replaced in s as fol-
lows:
%a The abbreviated weekday name according to the cur-
rent locale.
%A The full weekday name according to the current
locale.
%b The abbreviated month name according to the current
locale.
%B The full month name according to the current
locale.
%c The preferred date and time representation for the
current locale.
%d The day of the month as a decimal number (range 0
to 31).
%H The hour as a decimal number using a 24-hour clock
(range 00 to 23).
%I The hour as a decimal number using a 12-hour clock
(range 01 to 12).
%j The day of the year as a decimal number (range 001
to 366).
%m The month as a decimal number (range 10 to 12).
%M The minute as a decimal number.
%p Either `am' or `pm' according to the given time
value, or the corresponding strings for the current
locale.
<h3>GNU July 2, 1993 1
</h3>
<h3>STRFTIME(3) Linux Programmer's Manual STRFTIME(3)
</h3>
%S The second as a decimal number.
%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.
%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.
%w The day of the week as a decimal, Sunday being 0.
%x The preferred date representation for the current
locale without the time.
%X The preferred time representation for the current
locale without the date.
%y The year as a decimal number without a century
(range 00 to 99).
%Y The year as a decimal number including the century.
%Z The time zone or name or abbreviation.
%% A literal `%' character.
The broken-down time structure tm is defined in <time.h>
as follows:
struct tm
{
int tm_sec; /* seconds */
int tm_min; /* minutes */
int tm_hour; /* hours */
int tm_mday; /* day of the month */
int tm_mon; /* month */
int tm_year; /* year */
int tm_wday; /* day of the week */
int tm_yday; /* day in the year */
int tm_isdst; /* daylight saving time */
};
The members of the tm structure are:
tm_sec The number of seconds after the minute, normally in
the range 0 to 59, but can be up to 61 to allow for
leap seconds.
tm_min The number of minutes after the hour, in the range
0 to 59.
tm_hour
The number of hours past midnight, in the range 0
<h3>GNU July 2, 1993 2
</h3>
<h3>STRFTIME(3) Linux Programmer's Manual STRFTIME(3)
</h3>
to 23.
tm_mday
The day of the month, in the range 1 to 31.
tm_mon The number of months since January, in the range 0
to 11.
tm_year
The number of years since 1900.
tm_wday
The number of days since Sunday, in the range 0 to
6.
tm_yday
The number of days since January 1, in the range 0
to 365.
tm_isdst
A flag that indicates whether daylight saving time
is in effect at the time described. The value is
positive if daylight saving time is in effect, zero
if it is not, and negative if the information is
not available.
<h3>RETURN VALUE
</h3> The strftime() function returns the number of characters
placed in the array s, not including the terminating NULL
character. If the value equals max, it means that the
array was too small.
<h3>CONFORMING TO
</h3> SVID 3, POSIX, BSD 4.3, ISO 9899
</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=date.htm>date</a>,
<a href=time.htm>time</a>,
<a href=ctime.htm>ctime</a>,
<a href=setlocale.htm>setlocale</a>,
<a href=sprintf.htm>sprintf</a>,
<pre>
<h3>NOTES
</h3> The function supports only those locales specified in
locale(7)
<h3>GNU July 2, 1993 3
</h3>
</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>
This manual page was brought to you by <i>mjl_man V-2.0</i>