php mktime

2021-12-07 13:32 PHP

<h1 >mktime</h1> <div class="refnamediv" ><a name="AEN26214" ></a> (PHP 3, PHP 4, PHP 5) mktime--取得一个日期的 Unix 时间戳</div> <div class="refsect1" ><a name="AEN26217" ></a> <h2>说明</h2> intmktime( [int hour [, int minute [, int second [, int month [, int day [, int year [, int is_dst]]]]]]] ) 根据给出的参数返回 Unix 时间戳。时间戳是一个长整数，包含了从 Unix 纪元（January 1 1970 00:00:00 GMT）到给定时间的秒数。 参数可以从右向左省略，任何省略的参数会被设置成本地日期和时间的当前值。 </div> <div class="refsect1" ><a name="AEN26245" ></a> <h2>参数</h2> <div class="variablelist"> <dl> <dt><var class="parameter">hour</var></dt> <dd> 小时数。 </dd> <dt><var class="parameter">minute</var></dt> <dd> 分钟数。 </dd> <dt><var class="parameter">second</var></dt> <dd> 秒数（一分钟之内）。 </dd> <dt><var class="parameter">month</var></dt> <dd> 月份数。 </dd> <dt><var class="parameter">day</var></dt> <dd> 天数。 </dd> <dt><var class="parameter">year</var></dt> <dd> 年份数，可以是两位或四位数字，0-69 对应于 2000-2069，70-100 对应于 1970-2000。在如今系统中普遍把 time_t 作为一个 32 位有符号整数的情况下，<var class="parameter">year</var>的合法范围是 1901 到 2038 之间，不过此限制自 PHP 5.1.0 起已被克服了。 </dd> <dt><var class="parameter">is_dst</var></dt> <dd> 本参数可以设为 1，表示正处于夏时制时间（DST），0 表示不是夏时制，或者 -1（默认值）表示不知道是否是夏时制。如果未知，PHP 会尝试自己搞明白。这可能产生不可预知（但并非不正确）的结果。如果 PHP 运行的系统中启用了 DST 或者<var class="parameter">is_dst</var>设为 1，某些时间是无效的。例如 DST 自 2:00 生效，则所有处于 2:00 到 3:00 之间的时间都无效，mktime()会返回一个未定义（通常为负）的值。某些系统（例如 Solaris 8）的 DST 在午夜生效，则 DST 生效当天的 0:30 会被计算为前一天的 23:30。 <div class="note"> <blockquote class="note"> 注:自 PHP 5.1.0 起，本参数已被废弃。应该使用新的时区处理特性来替代。 </blockquote> </div> </dd> </dl> </div> </div> <div class="refsect1" ><a name="AEN26289" ></a> <h2>返回值</h2> mktime()根据给出的参数返回 Unix 时间戳。如果参数非法（例如年，月，日都是零），本函数返回<tt class="constant">FALSE</tt>（在 PHP 5.1 之前返回<var class="literal">-1</var>）。 </div> <div class="refsect1" ><a name="AEN26295" ></a> <h2>更新日志</h2> <div class="informaltable"> <a name="AEN26298" ></a> <table border="1" class="CALSTABLE"> <colgroup> <col /> <col /> </colgroup> <thead> <tr> <th>版本</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td >3.0.10</td> <td >加入了<var class="parameter">is_dst</var>参数</td> </tr> <tr> <td >5.1.0</td> <td ><var class="parameter">is_dst</var>参数被废弃。出错时函数返回<tt class="constant">FALSE</tt>而不再是<var class="literal">-1</var></td> </tr> </tbody> </table> </div> </div> <div class="refsect1" ><a name="AEN26315" ></a> <h2>范例</h2> <table border="0" cellpadding="0" cellspacing="0" class="EXAMPLE" width="100%"> <tbody> <tr> <td > <div class="example"><a name="AEN26318" ></a> 例子 1.mktime()例子 mktime()在做日期计算和验证方面很有用，它会自动计算超出范围的输入的正确值。例如下面例子中每一行都会产生字符串 "Jan-01-1998"。 <table bgcolor="#e0e0e0" border="0" cellpadding="5" > <tbody> <tr> <td ><code><!--?php echodate("M-d-Y",mktime(0,0,0,12,32,1997)); echodate("M-d-Y",mktime(0,0,0,13,1,1997)); echodate("M-d-Y",mktime(0,0,0,1,1,1998)); echodate("M-d-Y",mktime(0,0,0,1,1,98)); ?></code></td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> <table border="0" cellpadding="0" cellspacing="0" class="EXAMPLE" width="100%"> <tbody> <tr> <td > <div class="example"><a name="AEN26325" ></a> 例子 2. 下个月的最后一天 任何给定月份的最后一天都可以被表示为下个月的第 "0" 天，而不是 -1 天。下面两个例子都会产生字符串 "The last day in Feb 2000 is: 29"。 <table bgcolor="#e0e0e0" border="0" cellpadding="5" > <tbody> <tr> <td ><code><!--?php $lastday=mktime(0,0,0,3,0,2000); echostrftime("Last day in Feb 2000 is: %d",$lastday); $lastday=mktime(0,0,0,4, -31,2000); echostrftime("Last day in Feb 2000 is: %d",$lastday); ?></code></td> </tr> </tbody> </table> </div> </td> </tr> </tbody> </table> </div> <div class="refsect1" ><a name="AEN26329" ></a> <h2>注释</h2> <div class="caution"> <table border="1" class="caution" width="100%"> <tbody> <tr> <td align="center" >注意</td> </tr> <tr> <td align="left" > 在 PHP 5.1.0 之前，在任何已知 Windows 版本以及一些其它系统下不支持负的时间戳。因此年份的有效范围限制为 1970 到 2038。 </td> </tr> </tbody> </table> </div> </div> <div class="refsect1" ><a name="AEN26333" ></a> <h2>参见</h2> <table border="0" > <tbody> <tr> <td ><a href="mk:@MSITStore:C:Documents%20and%20SettingsAdministrator桌面php手册.chm::/fancy/function.gmmktime.html">gmmktime()</a></td> </tr> <tr> <td ><a href="mk:@MSITStore:C:Documents%20and%20SettingsAdministrator桌面php手册.chm::/fancy/function.date.html">date()</a></td> </tr> <tr> <td ><a href="mk:@MSITStore:C:Documents%20and%20SettingsAdministrator桌面php手册.chm::/fancy/function.time.html">time()</a></td> </tr> </tbody> </table> </div>