localtime
(PHP 4, PHP 5, PHP 7, PHP 8)
localtime — 取得本地时间
说明
localtime
( int
$timestamp
= time()
, bool $is_associative
= false
) : arraylocaltime() 函数返回一个数组,其结构和 C 函数调用返回的完全一样。
参数
-
timestamp
-
可选的
timestamp
参数是一个 int 的 Unix 时间戳,如未指定或是null
,参数值默认为当前本地时间。也就是说,其值默认为 time() 的返回值。 -
is_associative
-
如果设为
false
或未提供则返回的是普通的数字索引数组。如果该参数设为true
则 localtime() 函数返回包含有所有从 C 的 localtime 函数调用所返回的不同单元的关联数组。关联数组中不同的键名为:-
"tm_sec" - 秒数,
0
到59
-
"tm_min" - 分钟数,
0
到59
-
"tm_hour" - 小时,
0
到23
-
"tm_mday" - 月份中的第几日,
1
到31
-
"tm_mon" - 年份中的第几个月,
0
(Jan) 到11
(Dec) - "tm_year" - 年份,从 1900 开始
-
"tm_wday" - 星期中的第几天,
0
(Sun) 到6
(Sat) -
"tm_yday" - 一年中的第几天,
0
到365
-
"tm_isdst" - 夏令时当前是否生效?
如果是生效的是正数,
0
代表未生效,负数代表未知。
-
"tm_sec" - 秒数,
错误/异常
在每 次调用日期/时间函数时,如果时区无效则会引发 E_NOTICE
错误,如果使用系统设定值或 TZ
环境变量,则会引发 E_STRICT
或 E_WARNING
消息。参见
date_default_timezone_set()。
更新日志
版本 | 说明 |
---|---|
5.1.0 |
现在发布 |
范例
示例 #1 localtime() 例子
<?php
$localtime = localtime();
$localtime_assoc = localtime(time(), true);
print_r($localtime);
print_r($localtime_assoc);
?>
以上例程的输出类似于:
Array ( [0] => 24 [1] => 3 [2] => 19 [3] => 3 [4] => 3 [5] => 105 [6] => 0 [7] => 92 [8] => 1 ) Array ( [tm_sec] => 24 [tm_min] => 3 [tm_hour] => 19 [tm_mday] => 3 [tm_mon] => 3 [tm_year] => 105 [tm_wday] => 0 [tm_yday] => 92 [tm_isdst] => 1 )