localtime | searchcode

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

https://github.com/tsgates/cclookup
#! | 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&amp;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&amp;tseed=1289693594" />
<link rel="stylesheet" media="all" type="text/css" href="../../lib/exe/css.php@s=all&amp;t=custom1&amp;tseed=1289693594" />
<link rel="stylesheet" media="print" type="text/css" href="../../lib/exe/css.php@s=print&amp;t=custom1&amp;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 &lt;ctime&gt;</span>
&nbsp;
<span class="kw4">struct</span> <span class="kw4">tm</span> <span class="sy2">*</span><span class="kw3">localtime</span><span class="br0">&#40;</span> <span class="kw4">const</span> <span class="kw4">time_t</span> <span class="sy2">*</span><span class="kw3">time</span> <span class="br0">&#41;</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">&#40;</span> <span class="sy3">&amp;</span>time_since_epoch <span class="br0">&#41;</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">&#40;</span> <span class="sy3">&amp;</span>time_since_epoch <span class="br0">&#41;</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">&lt;&lt;</span> <span class="st0">&quot;The time is: &quot;</span> <span class="sy1">&lt;&lt;</span> std<span class="sy4">::</span><span class="kw3">asctime</span><span class="br0">&#40;</span> current_time <span class="br0">&#41;</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>