2024 年 PHP 日本研討會

gmmktime

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

gmmktime取得 GMT 日期對應的 Unix 時間戳記

說明

gmmktime(
    int $hour,
    ?int $minute = null,
    ?int $second = null,
    ?int $month = null,
    ?int $day = null,
    ?int $year = null
): int|false

除了傳入的參數代表格林威治標準時間的日期之外,與 mktime() 完全相同。 gmmktime() 內部使用 mktime(),因此只能使用衍生本地時間有效的時間。

如同 mktime(),可以從右到左省略選用參數,任何省略的參數將被設定為目前對應的格林威治標準時間值。

不支援在沒有任何參數的情況下呼叫 gmmktime(),並且將導致 ArgumentCountError。 可以使用 time() 來取得目前的時間戳記。

參數

hour(小時)

相對於由 monthdayyear 決定的一日開始的小時數。負值表示該日午夜之前的小時。大於 23 的值表示後續日期的相應小時。

minute(分鐘)

相對於 hour 開始的分鐘數。負值表示前一小時計的分鐘數。大於 59 的值表示後續小時的相應分鐘數。

second(秒)

相對於 minute 開始的秒數。負值表示前一分鐘的秒數。大於 59 的值表示後續分鐘的相應秒數。

month(月份)

相對於前一年結束的月份數。值 1 到 12 表示該年的正常日曆月份。小於 1 的值(包括負值)表示前一年的月份,以相反順序排列,因此 0 是 12 月,-1 是 11 月,依此類推。大於 12 的值表示後續年份的相應月份。

day(日)

相對於前一個月結束的日數。值 1 到 28、29、30 或 31(取決於月份)表示相關月份的正常日期。小於 1 的值(包括負值)表示前一個月的日期,因此 0 是前一個月的最後一天,-1 是前一天,依此類推。大於相關月份天數的值表示後續月份的相應日期。

year(年)

年份

回傳值

成功時傳回 整數 (int) Unix 時間戳記,如果時間戳記不符合 PHP 整數範圍則傳回 false

更新日誌

版本 說明
8.0.0 hour 不再是可選參數。 如果您需要 Unix 時間戳記,請使用 time()
8.0.0 minutesecondmonthdayyear 現在可以為 null。

範例

範例 #1 gmmktime() 基本範例

<?php
// 顯示:2000 年 7 月 1 日是星期六
echo "2000 年 7 月 1 日是星期 " . date("l", gmmktime(0, 0, 0, 7, 1, 2000));
?>

參見

新增註釋

使用者提供的註釋

此頁面沒有使用者提供的註釋。
To Top