266 lines
13 KiB
HTML
266 lines
13 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="zh" dir="ltr" class="client-nojs" xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh">
|
|
<head><meta http-equiv="x-ua-compatible" content="ie=edge">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>标准库头文件 <ctime></title>
|
|
<link rel="stylesheet" href="ext.css" />
|
|
<link rel="stylesheet" href="site_modules.css" />
|
|
</head>
|
|
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-cpp_header_ctime skin-cppreference2 action-view cpp-navbar">
|
|
<div id="cpp-content-base">
|
|
<div id="content"><a id="top"></a>
|
|
<h1 id="firstHeading" class="firstHeading"><span style="font-size:0.7em; line-height:130%">标准库头文件</span> <ctime></h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-header.html">header</a></span></div>
|
|
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
|
|
<p>此头文件原作为 <code><b><time.h></b></code> 存在于 C 标准库。</p>
|
|
<p>此头文件是 <a href="cpp-chrono-c.html">C 风格日期和时间</a>库的一部分。</p>
|
|
<table class="t-dsc-begin">
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.AE.8F.E5.B8.B8.E9.87.8F">宏常量</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-CLOCKS_PER_SEC.html"><span class="t-lines"><span>CLOCKS_PER_SEC</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>每秒的处理器始时钟嘀嗒数<br />
|
|
<span class="t-mark">(宏常量)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-types-NULL.html"><span class="t-lines"><span>NULL</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>实现定义的空指针常量<br />
|
|
<span class="t-mark">(宏常量)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E7.B1.BB.E5.9E.8B">类型</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-clock_t.html"><span class="t-lines"><span>clock_t</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>进程运行时间<br />
|
|
<span class="t-mark">(typedef)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-types-size_t.html"><span class="t-lines"><span>size_t</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td><a href="cpp-language-sizeof.html"><tt>sizeof</tt></a> 运算符返回的无符号整数类型<br />
|
|
<span class="t-mark">(typedef)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-time_t.html"><span class="t-lines"><span>time_t</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>从纪元起的时间类型<br />
|
|
<span class="t-mark">(typedef)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-tm.html"><span class="t-lines"><span>tm</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>日历时间类型<br />
|
|
<span class="t-mark">(类)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-timespec.html"><span class="t-lines"><span>timespec</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>以秒和纳秒表示的时间<br />
|
|
<span class="t-mark">(结构体)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.87.BD.E6.95.B0">函数</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h5><span class="mw-headline" id=".E6.97.B6.E9.97.B4.E6.93.8D.E4.BD.9C">时间操作</span></h5>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-clock.html"><span class="t-lines"><span>clock</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>返回自程序启动时起的原始处理器时钟时间<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-time.html"><span class="t-lines"><span>time</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>返回自纪元起计的系统当前时间<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-difftime.html"><span class="t-lines"><span>difftime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>计算时间之间的差<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-timespec_get.html"><span class="t-lines"><span>timespec_get</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>返回基于给定时间基底的日历时间<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h5><span class="mw-headline" id=".E6.A0.BC.E5.BC.8F.E8.BD.AC.E6.8D.A2">格式转换</span></h5>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-ctime.html"><span class="t-lines"><span>ctime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换 <code>time_t</code> 对象为文本表示<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-asctime.html"><span class="t-lines"><span>asctime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换 <code>tm</code> 对象为文本表示<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-strftime.html"><span class="t-lines"><span>strftime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换 <code>tm</code> 对象到自定义的文本表示<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-wcsftime.html"><span class="t-lines"><span>wcsftime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换 <code>tm</code> 对象为定制的宽字符串文本表示<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-gmtime.html"><span class="t-lines"><span>gmtime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换纪元起时间为以协调世界时表示的日历时间<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-localtime.html"><span class="t-lines"><span>localtime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换纪元起时间为以本地时间表示的日历时间<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-chrono-c-mktime.html"><span class="t-lines"><span>mktime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>转换日历时间为纪元起的时间<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E6.A6.82.E8.A6.81">概要</span></h3>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="co2">#define NULL /* 见描述 */</span>
|
|
<span class="co2">#define CLOCKS_PER_SEC /* 见描述 */</span>
|
|
<span class="co2">#define TIME_UTC /* 见描述 */</span>
|
|
|
|
<span class="kw1">namespace</span> std <span class="br0">{</span>
|
|
<span class="kw1">using</span> size_t <span class="sy1">=</span> <span class="coMULTI">/* 见描述 */</span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> clock_t <span class="sy1">=</span> <span class="coMULTI">/* 见描述 */</span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> time_t <span class="sy1">=</span> <span class="coMULTI">/* 见描述 */</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">struct</span> timespec<span class="sy4">;</span>
|
|
<span class="kw1">struct</span> tm<span class="sy4">;</span>
|
|
|
|
clock_t clock<span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">double</span> difftime<span class="br0">(</span>time_t time1, time_t time0<span class="br0">)</span><span class="sy4">;</span>
|
|
time_t mktime<span class="br0">(</span>tm<span class="sy2">*</span> timeptr<span class="br0">)</span><span class="sy4">;</span>
|
|
time_t time<span class="br0">(</span>time_t<span class="sy2">*</span> timer<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">int</span> timespec_get<span class="br0">(</span>timespec<span class="sy2">*</span> ts, <span class="kw4">int</span> base<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">char</span><span class="sy2">*</span> asctime<span class="br0">(</span><span class="kw4">const</span> tm<span class="sy2">*</span> timeptr<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">char</span><span class="sy2">*</span> ctime<span class="br0">(</span><span class="kw4">const</span> time_t<span class="sy2">*</span> timer<span class="br0">)</span><span class="sy4">;</span>
|
|
tm<span class="sy2">*</span> gmtime<span class="br0">(</span><span class="kw4">const</span> time_t<span class="sy2">*</span> timer<span class="br0">)</span><span class="sy4">;</span>
|
|
tm<span class="sy2">*</span> localtime<span class="br0">(</span><span class="kw4">const</span> time_t<span class="sy2">*</span> timer<span class="br0">)</span><span class="sy4">;</span>
|
|
size_t strftime<span class="br0">(</span><span class="kw4">char</span><span class="sy2">*</span> s, size_t maxsize, <span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span> format, <span class="kw4">const</span> tm<span class="sy2">*</span> timeptr<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
<h3><span class="mw-headline" id=".E7.B1.BB_std::timespec">类 <span class="t-lc"><a href="cpp-chrono-c-timespec.html">std::timespec</a></span></span></h3>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">struct</span> timespec <span class="br0">{</span>
|
|
<a href="cpp-chrono-c-time_t.html"><span class="kw1024">std::<span class="me2">time_t</span></span></a> tv_sec<span class="sy4">;</span>
|
|
<span class="kw4">long</span> tv_nsec<span class="sy4">;</span>
|
|
<span class="br0">}</span><span class="sy4">;</span></pre></div>
|
|
</div>
|
|
<h3><span class="mw-headline" id=".E7.B1.BB_std::tm">类 <span class="t-lc"><a href="cpp-chrono-c-tm.html">std::tm</a></span></span></h3>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">struct</span> tm <span class="br0">{</span>
|
|
<span class="kw4">int</span> tm_sec<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_min<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_hour<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_mday<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_mon<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_year<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_wday<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_yday<span class="sy4">;</span>
|
|
<span class="kw4">int</span> tm_isdst<span class="sy4">;</span>
|
|
<span class="br0">}</span><span class="sy4">;</span></pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|