/www.cppreference.com/wiki/chrono/c/localtime
#! | 106 lines | 93 code | 13 blank | 0 comment | 0 complexity | 4ea8c7bf1eb6535bbf27b2d51684e790 MD5 | raw file
- <!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>chrono:c:localtime</title>
- <meta name="generator" content="DokuWiki" />
- <meta name="robots" content="index,follow" />
- <meta name="date" content="2010-11-07T15:56:37-0800" />
- <meta name="keywords" content="chrono,c,localtime" />
- <link rel="search" type="application/opensearchdescription+xml" href="http://www.cppreference.com/wiki/lib/exe/opensearch.php" title="C++ Reference" />
- <link rel="start" href="../../../index.html" />
- <link rel="contents" href="http://www.cppreference.com/wiki/chrono/c/localtime?do=index" title="Sitemap" />
- <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="http://www.cppreference.com/wiki/feed.php" />
- <link rel="alternate" type="application/rss+xml" title="Current Namespace" href="http://www.cppreference.com/wiki/feed.php?mode=list&ns=chrono:c" />
- <link rel="alternate" type="text/html" title="Plain HTML" href="http://www.cppreference.com/wiki/_export/xhtml/chrono/c/localtime" />
- <link rel="alternate" type="text/plain" title="Wiki Markup" href="http://www.cppreference.com/wiki/_export/raw/chrono/c/localtime" />
- <link rel="canonical" href="localtime" />
- <link rel="stylesheet" media="screen" type="text/css" href="../../lib/exe/css.php@t=custom1&tseed=1289693594" />
- <link rel="stylesheet" media="all" type="text/css" href="../../lib/exe/css.php@s=all&t=custom1&tseed=1289693594" />
- <link rel="stylesheet" media="print" type="text/css" href="../../lib/exe/css.php@s=print&t=custom1&tseed=1289693594" />
- <script type="text/javascript" ><!--//--><![CDATA[//><!--
- var NS='chrono:c';var JSINFO = {"id":"chrono:c:localtime","namespace":"chrono:c"};
- //--><!]]></script>
- <script type="text/javascript" charset="utf-8" src="../../lib/exe/js.php@tseed=1289693594" ></script>
- </head>
- <body>
- <div class="dokuwiki export">
- <!-- TOC START -->
- <div class="toc">
- <div class="tocheader toctoggle" id="toc__header">Table of Contents</div>
- <div id="toc__inside">
- <ul class="toc">
- <li class="clear">
- <ul class="toc">
- <li class="level2"><div class="li"><span class="li"><a href="localtime#localtime" class="toc">localtime</a></span></div>
- <ul class="toc">
- <li class="level3"><div class="li"><span class="li"><a href="localtime#parameters" class="toc">Parameters</a></span></div></li>
- <li class="level3"><div class="li"><span class="li"><a href="localtime#return_value" class="toc">Return value</a></span></div></li>
- <li class="level3"><div class="li"><span class="li"><a href="localtime#example" class="toc">Example</a></span></div></li>
- <li class="level3"><div class="li"><span class="li"><a href="localtime#see_also" class="toc">See also</a></span></div></li></ul>
- </li></ul>
- </li></ul>
- </div>
- </div>
- <!-- TOC END -->
- <h2 class="sectionedit1"><a name="localtime" id="localtime">localtime</a></h2>
- <div class="level2">
- <pre class="cpp code cpp"><span class="co2">#include <ctime></span>
-
- <span class="kw4">struct</span> <span class="kw4">tm</span> <span class="sy2">*</span><span class="kw3">localtime</span><span class="br0">(</span> <span class="kw4">const</span> <span class="kw4">time_t</span> <span class="sy2">*</span><span class="kw3">time</span> <span class="br0">)</span><span class="sy4">;</span></pre>
- <p>
- Converts given time since epoch as <code>time_t</code> value into broken-down time, expressed in local time.
- </p>
- </div>
- <!-- EDIT1 SECTION "localtime" [1-199] -->
- <h3 class="sectionedit2"><a name="parameters" id="parameters">Parameters</a></h3>
- <div class="level3">
- <p>
- <code>time</code> - pointer to a <code>time_t</code> object
- </p>
- </div>
- <!-- EDIT2 SECTION "Parameters" [200-262] -->
- <h3 class="sectionedit3"><a name="return_value" id="return_value">Return value</a></h3>
- <div class="level3">
- <p>
- pointer to a static <code>tm</code> object on success, or <code>NULL</code> otherwise. The structure is shared between <code>gmtime</code> and <code>localtime</code> and is overwritten on each invocation.
- </p>
- </div>
- <!-- EDIT3 SECTION "Return value" [263-454] -->
- <h3 class="sectionedit4"><a name="example" id="example">Example</a></h3>
- <div class="level3">
- <pre class="cpp code cpp">std<span class="sy4">::</span><span class="kw4">time_t</span> time_since_epoch<span class="sy4">;</span>
- std<span class="sy4">::</span><span class="kw3">time</span><span class="br0">(</span> <span class="sy3">&</span>time_since_epoch <span class="br0">)</span><span class="sy4">;</span> <span class="co1">// get the time since epoch</span>
- std<span class="sy4">::</span><span class="kw4">tm</span> <span class="sy2">*</span>current_time <span class="sy1">=</span> std<span class="sy4">::</span><span class="kw3">localtime</span><span class="br0">(</span> <span class="sy3">&</span>time_since_epoch <span class="br0">)</span><span class="sy4">;</span> <span class="co1">// convert to broken-down local time</span>
- std<span class="sy4">::</span><span class="kw3">cout</span> <span class="sy1"><<</span> <span class="st0">"The time is: "</span> <span class="sy1"><<</span> std<span class="sy4">::</span><span class="kw3">asctime</span><span class="br0">(</span> current_time <span class="br0">)</span><span class="sy4">;</span></pre>
- <p>
- Output:
- </p>
- <pre class="code">
- The time is: Fri Oct 17 08:54:41 2008</pre>
- </div>
- <!-- EDIT4 SECTION "Example" [455-812] -->
- <h3 class="sectionedit5"><a name="see_also" id="see_also">See also</a></h3>
- <div class="level3">
- <p>
- <a href="gmtime" class="wikilink1" title="chrono:c:gmtime">gmtime</a>, <a href="ctime" class="wikilink1" title="chrono:c:ctime">ctime</a>, <a href="mktime" class="wikilink1" title="chrono:c:mktime">mktime</a>, <a href="time" class="wikilink1" title="chrono:c:time">time</a>
- </p>
- </div>
- <!-- EDIT5 SECTION "See also" [813-] --></div>
- </body>
- </html>