getdate
(PHP 4, PHP 5, PHP 7, PHP 8)
getdate — 取得日期／時間資訊
說明
getdate(int
$timestamp = time()): array 返回一個根據 timestamp 得出的包含有日期資訊的關聯陣列 array。如果沒有給出時間戳則認為是目前本地時間。
參數
-
timestamp 可選的
timestamp參數是一個 int 的 Unix 時間戳，如未指定或是null，參數值預設為目前本地時間。也就是說，其值預設為 time() 的返回值。
返回值
返回一個根據 timestamp 得出的包含有日期資訊的關聯陣列 array。
返回的關聯陣列中的鍵名單元有以下幾個：
| 鍵名 | 說明 | 返回值例子 |
|---|---|---|
"seconds" | 秒的數字表示 | 0 到 59 |
"minutes" | 分鐘的數字表示 | 0 到 59 |
"hours" | 小時的數字表示 | 0 到 23 |
"mday" | 月份中第幾天的數字表示 | 1 到 31 |
"wday" | 星期中第幾天的數字表示 | 0 (週日) 到 6 (週六) |
"mon" | 月份的數字表示 | 1 到 12 |
"year" | 4 位數字表示的完整年份 | 比如： 1999 或 2003 |
"yday" | 一年中第幾天的數字表示 | 0 到 365 |
"weekday" | 星期幾的完整文字表示 | Sunday 到 Saturday |
"month" | 月份的完整文字表示，比如 January 或 March | January 到 December |
0 | 自從 Unix 紀元開始至今的秒數，和 time() 的返回值以及用於 date() 的值類似。 | 系統相關，典型值為從 -2147483648 到 2147483647。 |
範例
示例 #1 getdate() 例子
<?php
$today = getdate();
print_r($today);
?> 以上例程的輸出類似於：
Array
(
[seconds] => 40
[minutes] => 58
[hours] => 21
[mday] => 17
[wday] => 2
[mon] => 6
[year] => 2003
[yday] => 167
[weekday] => Tuesday
[month] => June
[0] => 1055901520
)
參見
- date() - 格式化一個本地時間／日期
- idate() - 將本地時間日期格式化為整數
- localtime() - 取得本地時間
- time() - 返回目前的 Unix 時間戳
- setlocale() - 設定地區資訊