PHP 8.0.26 Released!

mktime

(PHP 4, PHP 5, PHP 7, PHP 8)

mktime取得一个日期的 Unix 时间戳

说明

mktime(
    int $hour,
    ?int $minute = null,
    ?int $second = null,
    ?int $month = null,
    ?int $day = null,
    ?int $year = null
): int|false

根据给出的参数返回 Unix 时间戳。时间戳是一个长整数,包含了从 Unix 纪元(January 1 1970 00:00:00 GMT)到给定时间的秒数。

任何省略或为 null 的参数都将根据本地日期和时间设置为当前值。

警告

请注意,参数的顺序是很奇怪:monthdayyear,而不是更合理的 yearmonthday 顺序。

弃用不带参数调用 mktime()time() 可以用来获取当前时间戳。

参数

hour

相对于一天开始的小时数,由 monthdayyear 确定。负值是指当天零点前的小时。值大于 23 是指接下来几天的适当小时。

minute

相对于 hour 开始的分钟数。负值指的是上个小时的分钟。大于 59 的值将指向接下来几个小时的适当分钟。

second

相对于 minute 开始的秒数。负值是指前一分钟的秒数。大于 59 的值是指接下来几分钟的适当秒。

month

相对于去年年底的月份数。值 1 到 12 是指相关年份的正常日历月份。小于 1 的值(包括负值)按相反的顺序指向去年的月份,因此 0 是 12 月,-1 是 11 月,以此类推。值大于 12 是指接下来几年的适当月份。

day

相对于上个月月底的天数。值 1 到 28、29、30 或 31(取决于月份)是指相关月份的正常天数。小于 1 的值(包括负值)是指上个月的天数,因此 0 是上个月的最后一天,-1 是倒数第二天,以此类推。大于相关月份天数的值是指接下来几个月的适当某一天。

year

年份数,可以是两位或四位数字,0-69 对应于 2000-2069,70-100 对应于 1970-2000。在如今系统中普遍把 time_t 作为一个 32 位有符号整数的情况下,year 的合法范围是 1901 到 2038 之间。

返回值

mktime() 根据给出的参数返回 Unix 时间戳。

更新日志

版本 说明
8.0.0 hour 不再可选。
8.0.0 现在 minutesecondmonthdayyear 允许为 null。

范例

示例 #1 基本例子

<?php
// 设置使用的默认时区。
date_default_timezone_set('UTC');

// 打印:July 1, 2000 is on a Saturday
echo "July 1, 2000 is on a " date("l"mktime(000712000));

// 打印类似的东西:2006-04-05T01:02:03+00:00
echo date('c'mktime(123452006));
?>

示例 #2 mktime() 例子

mktime() 在做日期计算和验证方面很有用,它会自动计算超出范围的输入的正确值。例如下面例子中每一行都会产生字符串 "Jan-01-1998"。

<?php
echo date("M-d-Y"mktime(00012321997));
echo 
date("M-d-Y"mktime(0001311997));
echo 
date("M-d-Y"mktime(000111998));
echo 
date("M-d-Y"mktime(0001198));
?>

示例 #3 下个月的最后一天

任何给定月份的最后一天都可以被表示为下个月的第 "0" 天,而不是 -1 天。下面两个例子都会产生字符串 "The last day in Feb 2000 is: 29"。

<?php
$lastday 
mktime(000302000);
echo 
strftime("Last day in Feb 2000 is: %d"$lastday);
$lastday mktime(0004, -312000);
echo 
strftime("Last day in Feb 2000 is: %d"$lastday);
?>

参见

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top