(PHP 4, PHP 5)
mktime — 取得一个日期的 Unix 时间戳
$hour
[, int $minute
[, int $second
[, int $month
[, int $day
[, int $year
[, int $is_dst
]]]]]]] )根据给出的参数返回 Unix 时间戳。时间戳是一个长整数，包含了从 Unix 纪元（January 1 1970 00:00:00 GMT）到给定时间的秒数。
参数可以从右向左省略，任何省略的参数会被设置成本地日期和时间的当前值。
hour
小时数。
minute
分钟数。
second
秒数（一分钟之内）。
month
月份数。
day
天数。
year
年份数，可以是两位或四位数字，0-69 对应于 2000-2069，70-100
对应于 1970-2000。在如今系统中普遍把 time_t 作为一个 32
位有符号整数的情况下，year
的合法范围是 1901 到 2038 之间，不过此限制自
PHP 5.1.0 起已被克服了。
is_dst
本参数可以设为 1，表示正处于夏时制时间（DST），0
表示不是夏时制，或者 -1（默认值）表示不知道是否是夏时制。如果未知，PHP
会尝试自己搞明白。这可能产生不可预知（但并非不正确）的结果。如果
PHP 运行的系统中启用了 DST 或者 is_dst
设为 1，某些时间是无效的。例如 DST 自 2:00 生效，则所有处于
2:00 到 3:00 之间的时间都无效， mktime()
会返回一个未定义（通常为负）的值。某些系统（例如
Solaris 8）的 DST 在午夜生效，则 DST 生效当天的 0:30
会被计算为前一天的 23:30。
Note:
自 PHP 5.1.0 起，本参数已被废弃。应该使用新的时区处理特性来替代。
mktime() 根据给出的参数返回 Unix
时间戳。如果参数非法，本函数返回
FALSE（在 PHP 5.1 之前返回 -1）。
| 版本 | 说明 |
|---|---|
| 3.0.10 | 加入了 is_dst 参数 |
| 5.1.0 |
is_dst 参数被废弃。出错时函数返回
FALSE 而不再是 -1。修正了本函数可以接受年月日参数全为零。
|
在每 次调用日期/时间函数时，如果时区无效则会引发 E_NOTICE 错误，如果使用系统设定值或 TZ
环境变量，则会引发 E_STRICT 或 E_WARNING 消息。参见
date_default_timezone_set()
| 版本 | 说明 |
|---|---|
| 5.3.0 |
mktime() now throws E_DEPRECATED notice
if the is_dst parameter is used.
|
| 5.1.0 |
The is_dst parameter became deprecated.
Made the function return FALSE on error, instead of
-1.
Fixed the function to accept the year, month and day to be all passed
as zero.
|
| 5.1.0 |
When called with no arguments, mktime() throws
E_STRICT notice. Use the
time() function instead.
|
| 5.1.0 |
现在发布 |
Example #1 mktime() 例子
mktime() 在做日期计算和验证方面很有用，它会自动计算超出范围的输入的正确值。例如下面例子中每一行都会产生字符串 "Jan-01-1998"。
<?php
echo date("M-d-Y", mktime(0, 0, 0, 12, 32, 1997));
echo date("M-d-Y", mktime(0, 0, 0, 13, 1, 1997));
echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 1998));
echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 98));
?>
Example #2 下个月的最后一天
任何给定月份的最后一天都可以被表示为下个月的第 "0" 天，而不是 -1 天。下面两个例子都会产生字符串 "The last day in Feb 2000 is: 29"。
<?php
$lastday = mktime(0, 0, 0, 3, 0, 2000);
echo strftime("Last day in Feb 2000 is: %d", $lastday);
$lastday = mktime(0, 0, 0, 4, -31, 2000);
echo strftime("Last day in Feb 2000 is: %d", $lastday);
?>
在 PHP 5.1.0 之前，在任何已知 Windows 版本以及一些其它系统下不支持负的时间戳。因此年份的有效范围限制为 1970 到 2038。