PHP date() 函數用於格式化時間/日期。
PHP date() 函數可把時間戳格式化為可讀性較好的日期和時間。
時間戳記是一個字元序列,表示一定的事件發生的日期/時間。
string date ( string $format [, int $timestamp ] )
參數 | 描述 |
---|---|
format | 必需。規定時間戳記的格式。 |
timestamp | 可選。規定時間戳。預設是當前的日期和時間。 |
date() 函數的第一個必要參數format規定如何格式化日期/時間。
這裡列出了一些可用的字元:
d - 代表月中的天(01 - 31)
m - 代表月(01 - 12)
Y - 代表年(四位數)
如需了解format參數中可用的所有字元列表,請查閱我們的PHP Date 參考手冊,date() 函數。
可以在字母之間插入其他字符,例如"/"、"." 或"-",這樣就可以增加附加格式了:
<?phpecho date("Y/m/d") . "<br>";echo date("Ymd") . "<br>";echo date("Ymd");?>
上面程式碼的輸出如下所示:
2016/10/212016.10.212016-10-21
format 字符 | 說明 | 傳回值例子 |
---|---|---|
日 | --- | --- |
d | 月中的第幾天,有前導零的2 位數字 | 01到31 |
D | 星期中的第幾天,文字表示,3 個字母 | Mon到Sun |
j | 月中的第幾天,沒有前導零 | 1到31 |
l ("L"的小寫字母) | 星期幾,完整的文字格式 | Sunday到Saturday |
N | ISO-8601 格式數字表示的星期中的第幾天(PHP 5.1.0 新加) | 1 (表示星期一)到7 (表示星期日) |
S | 每月天數後面的英文後綴,2 個字符 | st , nd , rd或th 。可以和j一起用 |
w | 在星期中的第幾天,數字表示 | 0 (表示星期日)到6 (表示星期六) |
z | 年份中的第幾天 | 0到365 |
星期 | --- | --- |
W | ISO-8601 格式年份中的第幾週,每週從星期一開始(PHP 4.1.0 新加的) | 例如: 42 (當年的第42 週) |
月 | --- | --- |
F | 月份,完整的文字格式,例如January 或March | January到December |
m | 數字表示的月份,有前導零 | 01到12 |
M | 三個字母縮寫表示的月份 | Jan到Dec |
n | 數字表示的月份,沒有前導零 | 1到12 |
t | 給定月份所應有的天數 | 28到31 |
年 | --- | --- |
L | 是否為閏年 | 如果是閏年為1 ,否則為0 |
o | ISO-8601 格式年份數字。這和Y的值相同,只有如果ISO 的星期數( W )屬於前一年或下一年,則用那一年。 (PHP 5.1.0 新加) | Examples: 1999 or 2003 |
Y | 4 位數字完整表示的年份 | 例如: 1999或2003 |
y | 2 位數字表示的年份 | 例如: 99或03 |
時間 | --- | --- |
a | 小寫的上午和下午值 | am或pm |
A | 大寫的上午和下午值 | AM或PM |
B | Swatch Internet 標準時 | 000到999 |
g | 小時,12 小時格式,無前導零 | 1到12 |
G | 小時,24 小時格式,無前導零 | 0到23 |
h | 小時,12 小時格式,有前導零 | 01到12 |
H | 小時,24 小時格式,有前導零 | 00到23 |
i | 有前導零的分鐘數 | 00到59 > |
s | 秒數,有前導零 | 00到59 > |
u | 毫秒(PHP 5.2.2 新加)。要注意的是date()函數總是回傳000000因為它只接受integer參數,而DateTime::format()才支援毫秒。 | 範例: 654321 |
時區 | --- | --- |
e | 時區識別(PHP 5.1.0 新加) | 例如: UTC , GMT , Atlantic/Azores |
I | 是否為夏令時 | 如果是夏令時為1 ,否則為0 |
O | 與格林威治時間相差的小時數 | 例如: +0200 |
P | 與格林威治時間(GMT)的差異,小時和分鐘之間有冒號分隔(PHP 5.1.3 新加) | 例如: +02:00 |
T | 本機所在的時區 | 例如: EST , MDT (【譯者註】在Windows 下方為完整文字格式,例如"Eastern Standard Time",中文版會顯示"中國標準時間")。 |
Z | 時差偏移量的秒數。 UTC 西邊的時區偏移總是負的,UTC 東邊的時區偏移量總是正的。 | -43200到43200 |
完整的日期/時間 | --- | --- |
c | ISO 8601 格式的日期(PHP 5 新加) | 2004-02-12T15:19:21+00:00 |
r | RFC 822 格式的日期 | 例如: Thu, 21 Dec 2000 16:01:07 +0200 |
U | 從Unix 紀元(January 1 1970 00:00:00 GMT)開始至今的秒數 | 參見time() |
如需查看所有日期函數的完整參考手冊,請造訪我們的完整的PHP Date 參考手冊。
這本參考手冊提供了每個函數的簡要描述和應用實例!