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 錯誤。參見
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
)