localtime

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

    localtime — 取得本地时间

    说明

    localtime(?int $timestamp = null, bool $associative = false): array

    localtime() 函数返回和 C 函数调用返回的结构相同数组。

    参数

    timestamp

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

    associative

    确定函数应该返回常规的数字索引数组还是关联数组。

    返回值

    如果 associative 设为 false 或未提供则返回的是普通的数字索引数组。如果 associative 设为 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 代表未生效，负数代表未知。

    错误／异常

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

    更新日志

    版本 说明
    8.0.0 现在 timestamp 可为 null。

    示例

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

    参见

    发现了问题？

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注

    此页面尚无用户贡献的备注。
    To Top