The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
 lang="en" dir="ltr">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>
    strftime    [C++ Reference]
  </title>

  <meta name="generator" content="DokuWiki Release 2009-12-25c &quot;Lemming&quot;" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2010-01-09T03:18:04-0800" />
<meta name="keywords" content="c,date,strftime" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/lib/exe/opensearch.php" title="C++ Reference" />
<link rel="start" href="/wiki/" />
<link rel="contents" href="/wiki/c/date/strftime?do=index" title="Index" />
<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/wiki/feed.php" />
<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="/wiki/feed.php?mode=list&amp;ns=c:date" />
<link rel="edit" title="Edit this page" href="/wiki/c/date/strftime?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/c/date/strftime" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/c/date/strftime" />
<link rel="canonical" href="http://www.cppreference.com/wiki/c/date/strftime" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&amp;t=custom1&amp;tseed=1272971091" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1&amp;tseed=1272971091" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&amp;t=custom1&amp;tseed=1272971091" />
<script type="text/javascript" charset="utf-8" ><!--//--><![CDATA[//><!--
var NS='c:date';var JSINFO = {"id":"c:date:strftime","namespace":"c:date"};
//--><!]]></script>
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?tseed=1272971091" ></script>

  <link rel="shortcut icon" href="/wiki/lib/tpl/custom1/images/favicon.png" />

  </head>

<body>
<div class="dokuwiki">
  
  <div class="stylehead">

    <div class="breadcrumbs">
      <span class="bchead">You are here: </span><a href="../../start.html"  title="start">C++ Reference</a> &raquo; <a href="../../c/start.html"  title="c:start">The Standard C Library</a> &raquo; <a href="../../c/date/start.html"  title="c:date:start">Standard C Date &amp; Time</a> &raquo; <a href="../../c/date/strftime.html"  title="c:date:strftime">strftime</a>    </div>
    
  </div>


  
  
  <div class="page">

    <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2828341-1";
urchinTracker();
</script>
    <!-- wikipage start -->
    


<h2><a name="strftime" id="strftime">strftime</a></h2>
<div class="level2">

<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;">    <span class="co2">#include &lt;ctime&gt;</span>
    size_t strftime<span class="br0">&#40;</span> <span class="kw4">char</span> <span class="sy0">*</span>str<span class="sy0">,</span> size_t maxsize<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">char</span> <span class="sy0">*</span>fmt<span class="sy0">,</span> <span class="kw4">struct</span> tm <span class="sy0">*</span>time <span class="br0">&#41;</span><span class="sy0">;</span></pre>
<p>
The function strftime() formats date and time information from time to a format specified by fmt, then stores the result in str (up to maxsize characters).
</p>

<p>
Certain codes may be used in fmt to specify different types of time:

</p>
<table class="inline">
	<tr class="row0">
		<th class="col0">Code</th><th class="col1">Meaning</th>
	</tr>
	<tr class="row1">
		<td class="col0"><code>%a</code></td><td class="col1">abbreviated weekday name (e.g. Fri)</td>
	</tr>
	<tr class="row2">
		<td class="col0"><code>%A</code></td><td class="col1">full weekday name (e.g. Friday)</td>
	</tr>
	<tr class="row3">
		<td class="col0"><code>%b</code></td><td class="col1">abbreviated month name (e.g. Oct)</td>
	</tr>
	<tr class="row4">
		<td class="col0"><code>%B</code></td><td class="col1">full month name (e.g. October)</td>
	</tr>
	<tr class="row5">
		<td class="col0"><code>%c</code></td><td class="col1">the standard date and time string</td>
	</tr>
	<tr class="row6">
		<td class="col0"><code>%d</code></td><td class="col1">day of the month, as a number (1-31)</td>
	</tr>
	<tr class="row7">
		<td class="col0"><code>%H</code></td><td class="col1">hour, 24 hour format (00-23)</td>
	</tr>
	<tr class="row8">
		<td class="col0"><code>%I</code></td><td class="col1">hour, 12 hour format (1-12)</td>
	</tr>
	<tr class="row9">
		<td class="col0"><code>%j</code></td><td class="col1">day of the year, as a number (1-366)</td>
	</tr>
	<tr class="row10">
		<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>
	</tr>
	<tr class="row11">
		<td class="col0"><code>%M</code></td><td class="col1">minute as a number (0-59)</td>
	</tr>
	<tr class="row12">
		<td class="col0"><code>%p</code></td><td class="col1">locale&#039;s equivalent of AM or PM</td>
	</tr>
	<tr class="row13">
		<td class="col0"><code>%S</code></td><td class="col1">second as a number (0-59)</td>
	</tr>
	<tr class="row14">
		<td class="col0"><code>%U</code></td><td class="col1">week of the year, (0-53), where week 1 has the first Sunday</td>
	</tr>
	<tr class="row15">
		<td class="col0"><code>%w</code></td><td class="col1">weekday as a decimal (0-6), where Sunday is 0</td>
	</tr>
	<tr class="row16">
		<td class="col0"><code>%W</code></td><td class="col1">week of the year, (0-53), where week 1 has the first Monday</td>
	</tr>
	<tr class="row17">
		<td class="col0"><code>%x</code></td><td class="col1">standard date string</td>
	</tr>
	<tr class="row18">
		<td class="col0"><code>%X</code></td><td class="col1">standard time string</td>
	</tr>
	<tr class="row19">
		<td class="col0"><code>%y</code></td><td class="col1">year in decimal, without the century (0-99)</td>
	</tr>
	<tr class="row20">
		<td class="col0"><code>%Y</code></td><td class="col1">year in decimal, with the century</td>
	</tr>
	<tr class="row21">
		<td class="col0"><code>%Z</code></td><td class="col1">time zone name</td>
	</tr>
	<tr class="row22">
		<td class="col0"><code>%%</code></td><td class="col1">a percent sign</td>
	</tr>
</table>

<p>

The strftime() function returns the number of characters put into str, or zero
if an error occurs.
</p>

<p>
Related Topics: <a href="../../c/date/gmtime.html" class="wikilink1" title="c:date:gmtime">gmtime</a>, <a href="../../c/date/localtime.html" class="wikilink1" title="c:date:localtime">localtime</a>, <a href="../../c/date/time.html" class="wikilink1" title="c:date:time">time</a>
</p>

</div>

    <!-- wikipage stop -->
  </div>

  <div class="clearer">&nbsp;</div>

  
  <div class="stylefoot">

    <div class="meta">
      <div class="user">
              </div>
      <!--
      <div class="doc">
        c/date/strftime.txt &middot; Last modified: 01/09/2010 03:18 by 83.226.88.197      </div>
      -->
    </div>

   
    </div></div></body>
</html>