mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-18 13:57:03 +08:00
199 lines
7.1 KiB
HTML
199 lines
7.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title>取得日期／时间信息</title>
|
|
</head>
|
|
<body class="docs"><div id="layout">
|
|
<div id="layout-content"><div id="function.getdate" class="refentry">
|
|
<div class="refnamediv">
|
|
<h1 class="refname">getdate</h1>
|
|
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">getdate</span> — <span class="dc-title">取得日期／时间信息</span></p>
|
|
|
|
</div>
|
|
<div class="refsect1 description" id="refsect1-function.getdate-description">
|
|
<h3 class="title">说明</h3>
|
|
<div class="methodsynopsis dc-description">
|
|
<span class="methodname"><strong>getdate</strong></span>
|
|
([ <span class="methodparam"><span class="type">int</span> <code class="parameter">$timestamp</code><span class="initializer"> = time()</span></span>
|
|
] ) : <span class="type">array</span></div>
|
|
|
|
<p class="para rdfs-comment">
|
|
返回一个根据 <code class="parameter">timestamp</code>
|
|
得出的包含有日期信息的关联数组 <span class="type"><a href="language.types.array.html" class="type array">array</a></span>。如果没有给出时间戳则认为是当前本地时间。
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 parameters" id="refsect1-function.getdate-parameters">
|
|
<h3 class="title">参数</h3>
|
|
<p class="para">
|
|
<dl>
|
|
|
|
|
|
<dt>
|
|
<code class="parameter">timestamp</code></dt>
|
|
<dd>
|
|
<p class="para">
|
|
可选的 <code class="parameter">timestamp</code> 参数是一个 <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span> 的 Unix
|
|
时间戳，如未指定，参数值默认为当前本地时间。也就是说，其值默认为
|
|
<span class="function"><a href="time.html" class="function">time()</a></span> 的返回值。</p></dd>
|
|
|
|
|
|
</dl>
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 returnvalues" id="refsect1-function.getdate-returnvalues">
|
|
<h3 class="title">返回值</h3>
|
|
<p class="para">
|
|
返回一个根据 <code class="parameter">timestamp</code>
|
|
得出的包含有日期信息的关联数组 <span class="type"><a href="language.types.array.html" class="type array">array</a></span>。
|
|
返回的关联数组中的键名单元有以下几个：
|
|
</p>
|
|
<p class="para">
|
|
<table class="doctable table">
|
|
<caption><strong>返回的关联数组中的键名单元</strong></caption>
|
|
|
|
<thead>
|
|
<tr>
|
|
<th>键名</th>
|
|
<th>说明</th>
|
|
<th>返回值例子</th>
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
<tbody class="tbody">
|
|
<tr>
|
|
<td><em>"seconds"</em></td>
|
|
<td>秒的数字表示</td>
|
|
<td><em>0</em> 到 <em>59</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"minutes"</em></td>
|
|
<td>分钟的数字表示</td>
|
|
<td><em>0</em> 到 <em>59</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"hours"</em></td>
|
|
<td>小时的数字表示</td>
|
|
<td><em>0</em> 到 <em>23</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"mday"</em></td>
|
|
<td>月份中第几天的数字表示</td>
|
|
<td><em>1</em> 到 <em>31</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"wday"</em></td>
|
|
<td>星期中第几天的数字表示</td>
|
|
<td><em>0</em> (周日) 到 <em>6</em> (周六)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"mon"</em></td>
|
|
<td>月份的数字表示</td>
|
|
<td><em>1</em> 到 <em>12</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"year"</em></td>
|
|
<td>4 位数字表示的完整年份</td>
|
|
<td>比如： <em>1999</em> 或 <em>2003</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"yday"</em></td>
|
|
<td>一年中第几天的数字表示</td>
|
|
<td><em>0</em> 到 <em>365</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"weekday"</em></td>
|
|
<td>星期几的完整文本表示</td>
|
|
<td><em>Sunday</em> 到 <em>Saturday</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>"month"</em></td>
|
|
<td>月份的完整文本表示，比如 January 或 March</td>
|
|
<td><em>January</em> 到 <em>December</em></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>0</em></td>
|
|
<td>
|
|
自从 Unix 纪元开始至今的秒数，和 <span class="function"><a href="time.html" class="function">time()</a></span>
|
|
的返回值以及用于 <span class="function"><a href="date.html" class="function">date()</a></span> 的值类似。
|
|
</td>
|
|
<td>
|
|
系统相关，典型值为从 <em>-2147483648</em> 到
|
|
<em>2147483647</em>。
|
|
</td>
|
|
</tr>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 examples" id="refsect1-function.getdate-examples">
|
|
<h3 class="title">范例</h3>
|
|
<p class="para">
|
|
<div class="example" id="example-2720">
|
|
<p><strong>Example #1 <span class="function"><strong>getdate()</strong></span> 例子</strong></p>
|
|
<div class="example-contents">
|
|
<div class="phpcode"><pre><span style="color: #000000">
|
|
<span style="color: #0000BB"><?php<br />$today </span><span style="color: #007700">= </span><span style="color: #0000BB">getdate</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$today</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
|
|
</span>
|
|
</pre></div>
|
|
</div>
|
|
|
|
<div class="example-contents"><p>以上例程的输出类似于：</p></div>
|
|
<div class="example-contents screen">
|
|
<div class="cdata"><pre>
|
|
Array
|
|
(
|
|
[seconds] => 40
|
|
[minutes] => 58
|
|
[hours] => 21
|
|
[mday] => 17
|
|
[wday] => 2
|
|
[mon] => 6
|
|
[year] => 2003
|
|
[yday] => 167
|
|
[weekday] => Tuesday
|
|
[month] => June
|
|
[0] => 1055901520
|
|
)
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 seealso" id="refsect1-function.getdate-seealso">
|
|
<h3 class="title">参见</h3>
|
|
<p class="para">
|
|
<ul class="simplelist">
|
|
<li class="member"><span class="function"><a href="date.html" class="function" rel="rdfs-seeAlso">date()</a> - 格式化一个本地时间／日期</span></li>
|
|
<li class="member"><span class="function"><a href="idate.html" class="function" rel="rdfs-seeAlso">idate()</a> - 将本地时间日期格式化为整数</span></li>
|
|
<li class="member"><span class="function"><a href="localtime.html" class="function" rel="rdfs-seeAlso">localtime()</a> - 取得本地时间</span></li>
|
|
<li class="member"><span class="function"><a href="time.html" class="function" rel="rdfs-seeAlso">time()</a> - 返回当前的 Unix 时间戳</span></li>
|
|
<li class="member"><span class="function"><a href="setlocale.html" class="function" rel="rdfs-seeAlso">setlocale()</a> - 设置地区信息</span></li>
|
|
</ul>
|
|
</p>
|
|
</div>
|
|
|
|
</div></div></div></body></html> |