PHP Conference Japan 2024

localtime

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

localtime取得本地時間

說明

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

localtime() 函式會返回一個與 C 函式呼叫返回的結構相同的陣列。

參數

timestamp

選用的 timestamp 參數是一個 int Unix 時間戳記,如果省略 timestamp 或其值為 null,則預設為目前的本地時間。換句話說,它預設為 time() 的值。

關聯式

決定函式是否應該返回一般的數字索引陣列,或是關聯式陣列。

回傳值

如果 associative 設為 false 或未提供,則陣列會以一般的數字索引陣列返回。如果 associative 設為 true,則 localtime() 會返回一個關聯式陣列,其中包含由 C 函式呼叫 localtime 所返回結構的元素。關聯式陣列的鍵如下:

  • "tm_sec" - 秒,059
  • "tm_min" - 分,059
  • "tm_hour" - 時,023
  • "tm_mday" - 月份中的日期,131
  • "tm_mon" - 年份中的月份,0(一月)到 11(十二月)
  • "tm_year" - 距離 1900 年的年數
  • "tm_wday" - 星期中的日期,0(星期日)到 6(星期六)
  • "tm_yday" - 年份中的日期,0365
  • "tm_isdst" - 是否正在實施日光節約時間? 正數表示是,0 表示否,負數表示未知。

錯誤/例外

如果時區無效,每次呼叫日期/時間函式都會產生 E_WARNING。另請參閱 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