(PHP 4, PHP 5)
localtime — 取得本地時間
說明
array localtime ([ int$timestamp
= time()
[, bool $is_associative
= false
]] )
localtime() 函數返回一個數組,其結構和 C 函數調用返回的完全一樣。
參數
timestamp
可選的 timestamp
參數是一個 integer 的 Unix
時間戳,如未指定,參數值默認為當前本地時間。也就是說,其值默認為
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 代表未生效,負數代表未知。
錯誤/異常
在每 次調用日期/時間函數時,如果時區無效則會引發 E_NOTICE
錯誤,如果使用系統設定值或 TZ
環境變量,則會引發 E_STRICT
或 E_WARNING
消息。參見
date_default_timezone_set()。
更新日志
版本 說明 5.1.0
現在發布 E_STRICT
和 E_NOTICE
時區錯誤。
范例
Example #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 )
參見
getdate() - 取得日期/時間信息