PageRenderTime 58ms CodeModel.GetById 29ms RepoModel.GetById 1ms app.codeStats 0ms

/www.cppreference.com/wiki/chrono/c/strftime

https://github.com/tsgates/cclookup
#! | 177 lines | 160 code | 17 blank | 0 comment | 0 complexity | 3f6d001e951cfb964c0cb9698709f813 MD5 | raw file
    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    2. 

  2.  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
    4. 

  4.  lang="en" dir="ltr">
    5. 

  5. <head>
    6. 

  6.   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    7. 

  7.   <title>chrono:c:strftime</title>
    8. 

  8. <meta name="generator" content="DokuWiki" />
    9. 

  9. <meta name="robots" content="index,follow" />
    10. 

  10. <meta name="date" content="2010-11-07T16:00:06-0800" />
    11. 

  11. <meta name="keywords" content="chrono,c,strftime" />
    12. 

  12. <link rel="search" type="application/opensearchdescription+xml" href="http://www.cppreference.com/wiki/lib/exe/opensearch.php" title="C++ Reference" />
    13. 

  13. <link rel="start" href="../../../index.html" />
    14. 

  14. <link rel="contents" href="http://www.cppreference.com/wiki/chrono/c/strftime?do=index" title="Sitemap" />
    15. 

  15. <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="http://www.cppreference.com/wiki/feed.php" />
    16. 

  16. <link rel="alternate" type="application/rss+xml" title="Current Namespace" href="http://www.cppreference.com/wiki/feed.php?mode=list&amp;ns=chrono:c" />
    17. 

  17. <link rel="alternate" type="text/html" title="Plain HTML" href="http://www.cppreference.com/wiki/_export/xhtml/chrono/c/strftime" />
    18. 

  18. <link rel="alternate" type="text/plain" title="Wiki Markup" href="http://www.cppreference.com/wiki/_export/raw/chrono/c/strftime" />
    19. 

  19. <link rel="canonical" href="strftime" />
    20. 

  20. <link rel="stylesheet" media="screen" type="text/css" href="../../lib/exe/css.php@t=custom1&amp;tseed=1289693594" />
    21. 

  21. <link rel="stylesheet" media="all" type="text/css" href="../../lib/exe/css.php@s=all&amp;t=custom1&amp;tseed=1289693594" />
    22. 

  22. <link rel="stylesheet" media="print" type="text/css" href="../../lib/exe/css.php@s=print&amp;t=custom1&amp;tseed=1289693594" />
    23. 

  23. <script type="text/javascript" ><!--//--><![CDATA[//><!--
    24. 

  24. var NS='chrono:c';var JSINFO = {"id":"chrono:c:strftime","namespace":"chrono:c"};
    25. 

  25. //--><!]]></script>
    26. 

  26. <script type="text/javascript" charset="utf-8" src="../../lib/exe/js.php@tseed=1289693594" ></script>
    27. 

  27. </head>
    28. 

  28. <body>
    29. 

  29. <div class="dokuwiki export">
    30. 

  30. <!-- TOC START -->
    31. 

  31. <div class="toc">
    32. 

  32. <div class="tocheader toctoggle" id="toc__header">Table of Contents</div>
    33. 

  33. <div id="toc__inside">
    34. 

  34. 

  35. <ul class="toc">
    36. 

  36. <li class="clear">
    37. 

  37. 

  38. <ul class="toc">
    39. 

  39. <li class="level2"><div class="li"><span class="li"><a href="strftime#strftime" class="toc">strftime</a></span></div>
    40. 

  40. <ul class="toc">
    41. 

  41. <li class="level3"><div class="li"><span class="li"><a href="strftime#parameters" class="toc">Parameters</a></span></div></li>
    42. 

  42. <li class="level3"><div class="li"><span class="li"><a href="strftime#return_value" class="toc">Return value</a></span></div></li>
    43. 

  43. <li class="level3"><div class="li"><span class="li"><a href="strftime#see_also" class="toc">See also</a></span></div></li></ul>
    44. 

  44. </li></ul>
    45. 

  45. </li></ul>
    46. 

  46. </div>
    47. 

  47. </div>
    48. 

  48. <!-- TOC END -->
    49. 

  49. 

  50. <h2 class="sectionedit1"><a name="strftime" id="strftime">strftime</a></h2>
    51. 

  51. <div class="level2">
    52. 

  52. <pre class="cpp code cpp"><span class="co2">#include &lt;ctime&gt;</span>
    53. 

  53. &nbsp;
    54. 

  54. <span class="kw4">size_t</span> <span class="kw3">strftime</span><span class="br0">&#40;</span> <span class="kw4">char</span> <span class="sy2">*</span>buffer, <span class="kw4">size_t</span> buf_size, <span class="kw4">const</span> <span class="kw4">char</span> <span class="sy2">*</span>format, <span class="kw4">struct</span> <span class="kw4">tm</span> <span class="sy2">*</span><span class="kw3">time</span> <span class="br0">&#41;</span><span class="sy4">;</span></pre>
    55. 

  55. <p>
    56. 

  56. Prints the date and time information from a given <code>tm</code> object to a character string according to specified format. Up to <code>buf_size</code> characters are written.
    57. 

  57. </p>
    58. 

  58. 

  59. </div>
    60. 

  60. <!-- EDIT1 SECTION "strftime" [1-305] -->
    61. 

  61. <h3 class="sectionedit2"><a name="parameters" id="parameters">Parameters</a></h3>
    62. 

  62. <div class="level3">
    63. 

  63. 

  64. <p>
    65. 

  65. 

  66. <code>buffer</code> - pointer to a character string to write the data information to
    67. 

  67. </p>
    68. 

  68. 

  69. <p>
    70. 

  70. <code>buf_size</code> - size of the <code>buffer</code> in bytes
    71. 

  71. </p>
    72. 

  72. 

  73. <p>
    74. 

  74. <code>format</code> - pointer to a character string specifying how to format the time and date string. The format can contain any combination of regular characters and following format specifiers:
    75. 

  75. 

  76. </p>
    77. 

  77. <div class="table sectionedit3"><table class="inline">
    78. 

  78. 	<tr class="row0">
    79. 

  79. 		<th class="col0">Code</th><th class="col1">Meaning</th>
    80. 

  80. 	</tr>
    81. 

  81. 	<tr class="row1">
    82. 

  82. 		<td class="col0"><code>%a</code> </td><td class="col1"> abbreviated weekday name (e.g. Fri) *</td>
    83. 

  83. 	</tr>
    84. 

  84. 	<tr class="row2">
    85. 

  85. 		<td class="col0"><code>%A</code> </td><td class="col1"> full weekday name (e.g. Friday) *</td>
    86. 

  86. 	</tr>
    87. 

  87. 	<tr class="row3">
    88. 

  88. 		<td class="col0"><code>%b</code> </td><td class="col1"> abbreviated month name (e.g. Oct) *</td>
    89. 

  89. 	</tr>
    90. 

  90. 	<tr class="row4">
    91. 

  91. 		<td class="col0"><code>%B</code> </td><td class="col1"> full month name (e.g. October) *</td>
    92. 

  92. 	</tr>
    93. 

  93. 	<tr class="row5">
    94. 

  94. 		<td class="col0"><code>%c</code> </td><td class="col1"> the standard date and time string (Sun Oct 17 04:41:13 2010)*</td>
    95. 

  95. 	</tr>
    96. 

  96. 	<tr class="row6">
    97. 

  97. 		<td class="col0"><code>%d</code> </td><td class="col1"> day of the month, as a number (1-31)</td>
    98. 

  98. 	</tr>
    99. 

  99. 	<tr class="row7">
    100. 

  100. 		<td class="col0"><code>%H</code> </td><td class="col1"> hour, 24 hour format (00-23)</td>
    101. 

  101. 	</tr>
    102. 

  102. 	<tr class="row8">
    103. 

  103. 		<td class="col0"><code>%I</code> </td><td class="col1"> hour, 12 hour format (1-12)</td>
    104. 

  104. 	</tr>
    105. 

  105. 	<tr class="row9">
    106. 

  106. 		<td class="col0"><code>%j</code> </td><td class="col1"> day of the year, as a number (1-366)</td>
    107. 

  107. 	</tr>
    108. 

  108. 	<tr class="row10">
    109. 

  109. 		<td class="col0"><code>%m</code> </td><td class="col1"> month as a number (1-12). Note: some versions of Microsoft Visual C++ may use values that range from 0-11.</td>
    110. 

  110. 	</tr>
    111. 

  111. 	<tr class="row11">
    112. 

  112. 		<td class="col0"><code>%M</code> </td><td class="col1"> minute as a number (0-59)</td>
    113. 

  113. 	</tr>
    114. 

  114. 	<tr class="row12">
    115. 

  115. 		<td class="col0"><code>%p</code> </td><td class="col1"> locale&#039;s equivalent of AM or PM</td>
    116. 

  116. 	</tr>
    117. 

  117. 	<tr class="row13">
    118. 

  118. 		<td class="col0"><code>%S</code> </td><td class="col1"> second as a number (0-59)</td>
    119. 

  119. 	</tr>
    120. 

  120. 	<tr class="row14">
    121. 

  121. 		<td class="col0"><code>%U</code> </td><td class="col1"> week of the year, (0-53), where week 1 has the first Sunday</td>
    122. 

  122. 	</tr>
    123. 

  123. 	<tr class="row15">
    124. 

  124. 		<td class="col0"><code>%w</code> </td><td class="col1"> weekday as a decimal (0-6), where Sunday is 0</td>
    125. 

  125. 	</tr>
    126. 

  126. 	<tr class="row16">
    127. 

  127. 		<td class="col0"><code>%W</code> </td><td class="col1"> week of the year, (0-53), where week 1 has the first Monday</td>
    128. 

  128. 	</tr>
    129. 

  129. 	<tr class="row17">
    130. 

  130. 		<td class="col0"><code>%x</code> </td><td class="col1"> date representation</td>
    131. 

  131. 	</tr>
    132. 

  132. 	<tr class="row18">
    133. 

  133. 		<td class="col0"><code>%X</code> </td><td class="col1"> time representation</td>
    134. 

  134. 	</tr>
    135. 

  135. 	<tr class="row19">
    136. 

  136. 		<td class="col0"><code>%y</code> </td><td class="col1"> year in decimal, without the century (0-99)</td>
    137. 

  137. 	</tr>
    138. 

  138. 	<tr class="row20">
    139. 

  139. 		<td class="col0"><code>%Y</code> </td><td class="col1"> year in decimal, with the century</td>
    140. 

  140. 	</tr>
    141. 

  141. 	<tr class="row21">
    142. 

  142. 		<td class="col0"><code>%Z</code> </td><td class="col1"> time zone name</td>
    143. 

  143. 	</tr>
    144. 

  144. 	<tr class="row22">
    145. 

  145. 		<td class="col0"><code>%%</code> </td><td class="col1"> a percent sign</td>
    146. 

  146. 	</tr>
    147. 

  147. </table></div>
    148. 

  148. <!-- EDIT3 TABLE [640-1735] -->
    149. 

  149. <p>
    150. 

  150. 

  151. * - locale dependant
    152. 

  152. </p>
    153. 

  153. 

  154. </div>
    155. 

  155. <!-- EDIT2 SECTION "Parameters" [306-1758] -->
    156. 

  156. <h3 class="sectionedit4"><a name="return_value" id="return_value">Return value</a></h3>
    157. 

  157. <div class="level3">
    158. 

  158. 

  159. <p>
    160. 

  160. 

  161. number of characters put into <code>buffer</code> including the terminating <code>NULL</code> character on success. If the <code>buffer</code> was too small for the formatted string, <code>0</code> is returned and the contents of <code>buffer</code> are undefined.
    162. 

  162. </p>
    163. 

  163. 

  164. </div>
    165. 

  165. <!-- EDIT4 SECTION "Return value" [1759-2001] -->
    166. 

  166. <h3 class="sectionedit5"><a name="see_also" id="see_also">See also</a></h3>
    167. 

  167. <div class="level3">
    168. 

  168. 

  169. <p>
    170. 

  170. 

  171. <a href="gmtime" class="wikilink1" title="chrono:c:gmtime">gmtime</a>, <a href="localtime" class="wikilink1" title="chrono:c:localtime">localtime</a>, <a href="time" class="wikilink1" title="chrono:c:time">time</a>
    172. 

  172. </p>
    173. 

  173. 

  174. </div>
    175. 

  175. <!-- EDIT5 SECTION "See also" [2002-] --></div>
    176. 

  176. </body>
    177. 

  177. </html>
    178. 

  178.