localtime

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

localtime取得本地时间

说明

localtime(int $timestamp = time(), bool $is_associative = false): array

localtime() 函数返回一个数组,其结构和 C 函数调用返回的完全一样。

参数

timestamp

可选的 timestamp 参数是一个 int 的 Unix 时间戳,如未指定或是 null,参数值默认为当前本地时间。也就是说,其值默认为 time() 的返回值。

is_associative

如果设为 false 或未提供则返回的是普通的数字索引数组。如果该参数设为 truelocaltime() 函数返回包含有所有从 C 的 localtime 函数调用所返回的不同单元的关联数组。关联数组中不同的键名为:

  • "tm_sec" - 秒数, 059
  • "tm_min" - 分钟数, 059
  • "tm_hour" - 小时, 023
  • "tm_mday" - 月份中的第几日, 131
  • "tm_mon" - 年份中的第几个月, 0 (Jan) 到 11 (Dec)
  • "tm_year" - 年份,从 1900 开始
  • "tm_wday" - 星期中的第几天, 0 (Sun) 到 6 (Sat)
  • "tm_yday" - 一年中的第几天, 0365
  • "tm_isdst" - 夏令时当前是否生效? 如果是生效的是正数, 0 代表未生效,负数代表未知。

错误/异常

在每次调用日期/时间函数时,如果时区无效则会引发 E_NOTICE 错误。参见 date_default_timezone_set()

更新日志

版本 说明
5.1.0

现在发布 E_STRICTE_NOTICE 时区错误。

范例

示例 #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
)

参见