XXII. Date/Time 日期／時間函數

簡介

可以用這些函數得到 PHP 所運行的伺服器的日期及時間。可以用這些函數將日期及時間以很多不同模式格式化輸出。

注: 請留意這些函數依賴於伺服器的地區設定。確認在使用這些函數時考慮到了夏令時的設定（例如使用 $date = strtotime('+7 days', $date) 而不是 $date += 7*24*60*60）和閏年。

要編譯本增加模組無需外部庫檔案。

本增加模組作為 PHP 內核的一部分，無需安裝即可使用。

本增加模組在 php.ini 中未定義任何配置選項。

這些函數的行為受 php.ini 的影響。

表格 1. 日期／時間配置選項

名稱	預設值	可修改範圍	更新記錄
date.default_latitude	"31.7667"	PHP_INI_ALL	自 PHP 5.0.0 起可用
date.default_longitude	"35.2333"	PHP_INI_ALL	自 PHP 5.0.0 起可用
date.sunrise_zenith	"90.83"	PHP_INI_ALL	自 PHP 5.0.0 起可用
date.sunset_zenith	"90.83"	PHP_INI_ALL	自 PHP 5.0.0 起可用
date.timezone	""	PHP_INI_ALL	自 PHP 5.0.0 起可用

有關 PHP_INI_* 常量進一步的細節與定義參見附錄 G。

以下是配置選項的簡要解釋。

date.default_latitude float: 預設緯度。
date.default_longitude float: 預設經度。
date.sunrise_zenith float: 預設日出天頂。
date.sunset_zenith float: 預設日落天頂。
date.timezone string: 在未設定 TZ 環境變量時用於所有日期／時間函數的預設時區。優先順序在 date_default_timezone_get() 頁面中有說明。

注: 前四個配置選項目前僅用於 date_sunrise() 和 date_sunset()。

本增加模組未定義任何資源類型。

自 PHP 5.1.0 起定義有以下常量來提供標準日期表達方法，可以用於日期格式函數（例如 date()）。