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 參考手冊。
這本參考手冊提供了每個函數的簡要描述和應用實例!