localtime

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

localtime — 取得本地時間

說明

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

localtime() 函數(shù)返回一個數(shù)組，其結(jié)構(gòu)和 C 函數(shù)調(diào)用返回的完全一樣。

參數(shù)

timestamp

可選的 timestamp 參數(shù)是一個 int 的 Unix 時間戳，如未指定或是 null，參數(shù)值默認(rèn)為當(dāng)前本地時間。也就是說，其值默認(rèn)為 time() 的返回值。

is_associative

如果設(shè)為 false 或未提供則返回的是普通的數(shù)字索引數(shù)組。如果該參數(shù)設(shè)為 true 則 localtime() 函數(shù)返回包含有所有從 C 的 localtime 函數(shù)調(diào)用所返回的不同單元的關(guān)聯(lián)數(shù)組。關(guān)聯(lián)數(shù)組中不同的鍵名為：

  • "tm_sec" - 秒數(shù)， 0 到 59
  • "tm_min" - 分鐘數(shù)， 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" - 夏令時當(dāng)前是否生效？ 如果是生效的是正數(shù)， 0 代表未生效，負(fù)數(shù)代表未知。

錯誤／異常

在每次調(diào)用日期/時間函數(shù)時，如果時區(qū)無效則會引發(fā) E_NOTICE 錯誤。參見 date_default_timezone_set()。

更新日志

版本 說明
5.1.0

現(xiàn)在發(fā)布 E_STRICT 和 E_NOTICE 時區(qū)錯誤。

范例

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

參見