mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-17 21:16:57 +08:00
265 lines
13 KiB
HTML
265 lines
13 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>将任何字符串的日期时间描述解析为 Unix 时间戳</title>
|
||
</head>
|
||
<body class="docs"><div id="layout">
|
||
<div id="layout-content"><div id="function.strtotime" class="refentry">
|
||
<div class="refnamediv">
|
||
<h1 class="refname">strtotime</h1>
|
||
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">strtotime</span> — <span class="dc-title">将任何字符串的日期时间描述解析为 Unix 时间戳</span></p>
|
||
|
||
</div>
|
||
<div class="refsect1 description" id="refsect1-function.strtotime-description">
|
||
<h3 class="title">说明</h3>
|
||
<div class="methodsynopsis dc-description">
|
||
<span class="methodname"><strong>strtotime</strong></span>
|
||
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$time</code></span>
|
||
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$now</code><span class="initializer"> = time()</span></span>
|
||
] ) : <span class="type">int</span></div>
|
||
|
||
<p class="simpara">
|
||
本函数预期接受一个包含美国英语日期格式的字符串并尝试将其解析为
|
||
Unix 时间戳（自 January 1 1970 00:00:00 GMT 起的秒数），其值相对于
|
||
<code class="parameter">now</code> 参数给出的时间，如果没有提供此参数则用系统当前时间。
|
||
</p>
|
||
<p class="para">
|
||
本函数将使用 <var class="envar">TZ</var> 环境变量（如果有的话）来计算时间戳。自
|
||
PHP 5.1.0 起有更容易的方法来定义时区用于所有的日期／时间函数。此过程在
|
||
<span class="function"><a href="date_default_timezone_get.html" class="function">date_default_timezone_get()</a></span> 函数页面中有说明。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 parameters" id="refsect1-function.strtotime-parameters">
|
||
<h3 class="title">参数</h3>
|
||
<p class="para">
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">time</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">日期/时间字符串。正确格式的说明详见 <a href="datetime.formats.html" class="link">日期与时间格式</a>。</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">now</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
用来计算返回值的时间戳。
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 returnvalues" id="refsect1-function.strtotime-returnvalues">
|
||
<h3 class="title">返回值</h3>
|
||
<p class="para">
|
||
成功则返回时间戳，否则返回 <strong><code>FALSE</code></strong>。在 PHP 5.1.0
|
||
之前本函数在失败时返回 <em>-1</em>。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 errors" id="refsect1-function.strtotime-errors">
|
||
<h3 class="title">错误／异常</h3>
|
||
|
||
<p class="para">
|
||
在每 次调用日期/时间函数时，如果时区无效则会引发 <strong><code>E_NOTICE</code></strong> 错误，如果使用系统设定值或 <var class="varname"><var class="varname">TZ</var></var>
|
||
环境变量，则会引发 <strong><code>E_STRICT</code></strong> 或 <strong><code>E_WARNING</code></strong> 消息。参见
|
||
<span class="function"><a href="date_default_timezone_set.html" class="function">date_default_timezone_set()</a></span>。</p>
|
||
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 changelog" id="refsect1-function.strtotime-changelog">
|
||
<h3 class="title">更新日志</h3>
|
||
<p class="para">
|
||
<table class="doctable informaltable">
|
||
|
||
<thead>
|
||
<tr>
|
||
<th>版本</th>
|
||
<th>说明</th>
|
||
</tr>
|
||
|
||
</thead>
|
||
|
||
<tbody class="tbody">
|
||
<tr>
|
||
<td>5.3.0</td>
|
||
<td>
|
||
Prior to PHP 5.3.0, relative time formats supplied to the
|
||
<code class="parameter">time</code> argument of <span class="function"><strong>strtotime()</strong></span>
|
||
such as <em>this week</em>, <em>previous week</em>,
|
||
<em>last week</em>, and <em>next week</em> were
|
||
interpreted to mean a 7 day period relative to the current date/time, rather
|
||
than a week period of <em>Monday</em> through <em>Sunday</em>.
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>5.3.0</td>
|
||
<td>
|
||
在 PHP 5.3.0 之前， <em>24:00</em> 不是一个有效的格式，并且 <span class="function"><strong>strtotime()</strong></span> 会返回 <strong><code>FALSE</code></strong>。
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>5.2.7</td>
|
||
<td>
|
||
In PHP 5 prior to 5.2.7, requesting a given occurrence of a
|
||
given weekday in a month where that weekday was the first day
|
||
of the month would incorrectly add one week to the returned
|
||
timestamp. This has been corrected in 5.2.7 and later
|
||
versions.
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>5.1.0</td>
|
||
<td>
|
||
失败时返回 <strong><code>FALSE</code></strong>，不再是 <em>-1</em>。
|
||
</td>
|
||
</tr>
|
||
|
||
|
||
<tr><td>5.1.0</td><td><p class="para">
|
||
现在发布 <strong><code>E_STRICT</code></strong> 和 <strong><code>E_NOTICE</code></strong>
|
||
时区错误。</p></td></tr>
|
||
|
||
|
||
<tr>
|
||
<td>5.0.2</td>
|
||
<td>
|
||
在 PHP 5 中到 5.0.2 之前，<em>"now"</em>
|
||
和其它相对时间从今天午夜起错误计算了。这和正确从当前时间起计算的其它版本不同。
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>5.0.0</td>
|
||
<td>
|
||
Microseconds began to be allowed, but they are ignored.
|
||
</td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
|
||
</table>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
|
||
<div class="refsect1 examples" id="refsect1-function.strtotime-examples">
|
||
<h3 class="title">范例</h3>
|
||
<p class="para">
|
||
<div class="example" id="example-2735">
|
||
<p><strong>Example #1 <span class="function"><strong>strtotime()</strong></span> 例子</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"now"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"10 September 2000"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"+1 day"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"+1 week"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"+1 week 2 days 4 hours 2 seconds"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"next Thursday"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #DD0000">"last Monday"</span><span style="color: #007700">), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
</div>
|
||
</p>
|
||
<p class="para">
|
||
<div class="example" id="example-2736">
|
||
<p><strong>Example #2 失败检查</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br />$str </span><span style="color: #007700">= </span><span style="color: #DD0000">'Not Good'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// previous to PHP 5.1.0 you would compare with -1, instead of false<br /></span><span style="color: #007700">if ((</span><span style="color: #0000BB">$timestamp </span><span style="color: #007700">= </span><span style="color: #0000BB">strtotime</span><span style="color: #007700">(</span><span style="color: #0000BB">$str</span><span style="color: #007700">)) === </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"The string (</span><span style="color: #0000BB">$str</span><span style="color: #DD0000">) is bogus"</span><span style="color: #007700">;<br />} else {<br /> echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$str</span><span style="color: #DD0000"> == " </span><span style="color: #007700">. </span><span style="color: #0000BB">date</span><span style="color: #007700">(</span><span style="color: #DD0000">'l dS of F Y h:i:s A'</span><span style="color: #007700">, </span><span style="color: #0000BB">$timestamp</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
</div>
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 notes" id="refsect1-function.strtotime-notes">
|
||
<h3 class="title">注释</h3>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
如果给定的年份是两位数字的格式，则其值 0-69 表示 2000-2069，70-100
|
||
表示 1970-2000。 See the notes
|
||
below for possible differences on 32bit systems (possible dates might end on
|
||
2038-01-19 03:14:07).
|
||
</p>
|
||
</p></blockquote>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
有效的时间戳通常从 Fri, 13 Dec 1901 20:45:54 GMT 到
|
||
Tue, 19 Jan 2038 03:14:07 GMT（对应于 32
|
||
位有符号整数的最小值和最大值）。
|
||
</p>
|
||
<p class="para">PHP 5.1.0 之前，不是所有的平台都支持负的时间戳，那么日记范围就被限制为不能早于
|
||
Unix 纪元。这意味着在 1970 年 1 月 1 日之前的日期将不能用在 Windows，一些
|
||
Linux 版本，以及几个其它的操作系统中。
|
||
</p>
|
||
<p class="para">
|
||
For 64-bit versions of PHP, the valid range of a timestamp is effectively
|
||
infinite, as 64 bits can represent approximately 293 billion years in either
|
||
direction.
|
||
</p>
|
||
</p></blockquote>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
Dates in the <em>m/d/y</em> or <em>d-m-y</em> formats
|
||
are disambiguated by looking at the separator between the various
|
||
components: if the separator is a slash (<em>/</em>), then the
|
||
American <em>m/d/y</em> is assumed; whereas if the separator is a
|
||
dash (<em>-</em>) or a dot (<em>.</em>), then the
|
||
European <em>d-m-y</em> format is assumed.
|
||
If, however, the year is given in a two digit format and the separator is a
|
||
dash (<em>-</em>, the date string is parsed as
|
||
<em>y-m-d</em>.
|
||
</p>
|
||
<p class="para">
|
||
To avoid potential ambiguity, it's best to use ISO 8601
|
||
(<em>YYYY-MM-DD</em>) dates or
|
||
<span class="methodname"><a href="datetime.createfromformat.html" class="methodname">DateTime::createFromFormat()</a></span> when possible.
|
||
</p>
|
||
</p></blockquote>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
Using this function for mathematical operations is not advisable.
|
||
It is better to use <span class="methodname"><a href="datetime.add.html" class="methodname">DateTime::add()</a></span> and
|
||
<span class="methodname"><a href="datetime.sub.html" class="methodname">DateTime::sub()</a></span> in PHP 5.3 and later, or
|
||
<span class="methodname"><a href="datetime.modify.html" class="methodname">DateTime::modify()</a></span> in PHP 5.2.
|
||
</p>
|
||
</p></blockquote>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 seealso" id="refsect1-function.strtotime-seealso">
|
||
<h3 class="title">参见</h3>
|
||
<p class="para">
|
||
<ul class="simplelist">
|
||
<li class="member"><a href="datetime.formats.html" class="link">Date and Time Formats</a></li>
|
||
<li class="member"><span class="methodname"><a href="datetime.createfromformat.html" class="methodname" rel="rdfs-seeAlso">DateTime::createFromFormat()</a> - 根据给定的格式解析日期时间字符串</span></li>
|
||
<li class="member"><span class="function"><a href="checkdate.html" class="function" rel="rdfs-seeAlso">checkdate()</a> - 验证一个格里高里日期</span></li>
|
||
<li class="member"><span class="function"><a href="strptime.html" class="function" rel="rdfs-seeAlso">strptime()</a> - 解析由 strftime 生成的日期／时间</span></li>
|
||
</ul>
|
||
</p>
|
||
</div>
|
||
|
||
</div></div></div></body></html> |