summaryrefslogtreecommitdiff
path: root/reference/C/MAN/strftime.htm
blob: 7154eae22b263db7d43a712a18146b07b14144ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
<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 &lt;time.h&gt;

       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 &lt;time.h&gt;
       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>