PHP date 格式化一個本地時間／日期

date (PHP 4, PHP 5)

date — 格式化一個本地時間／日期

說明 string date ( string $format [, int $timestamp ] ) 返回將整數 timestamp 按照給定的格式字串而產生的字符串。若是沒有給出時間戳則使用本地當前時間。換句話說，timestamp 是可選的，默認值爲 time()。

Tip 自 PHP 5.1.1 起有幾個有用的常量可用做標準的日期／時間格式來指定 format 參數。

Tip 自 PHP 5.1 起在 $_SERVER['REQUEST_TIME'] 中保存了發起該請求時刻的時間戳。

Note:

有效的時間戳典型範圍是格林威治時間 1901 年 12 月 13 日 20:45:54 到 2038 年 1 月 19 日 03:14:07。（此範圍符合 32 位有符號整數的最小值和最大值）。不過在 PHP 5.1 以前此範圍在某些系統（如 Windows）中限制爲從 1970 年 1 月 1 日到 2038 年 1 月 19 日。

Note:

要將字符串表達的時間轉換成時間戳，應該使用 strtotime()。此外一些數據庫有一些函數將其時間格式轉換成時間戳（例如 MySQL 的 » UNIX_TIMESTAMP 函數）。

格式字串能夠識別如下 format 參數的字符串 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 到 366 星期 --- --- 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> 時區 --- --- 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() 格式字串中不能被識別的字符將原樣顯示。Z 格式在使用 gmdate() 時老是返回 0。

Example #1 date() 例子

<?php // 設定要用的默認時區。自 PHP 5.1 可用 date_default_timezone_set('UTC'); // 輸出相似：Monday echo date("l"); // 輸出相似：Monday 15th of August 2005 03:12:46 PM echo date('l dS of F Y h:i:s A'); // 輸出：July 1, 2000 is on a Saturday echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); /* 在格式參數中使用常量 */ // 輸出相似：Mon, 15 Aug 2005 15:12:46 UTC echo date(DATE_RFC822); // 輸出相似：2000-07-01T00:00:00+00:00 echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); ?>

在格式字串中的字符前加上反斜線來轉義能夠避免它被按照上表解釋。若是加上反斜線後的字符自己就是一個特殊序列，那還要轉義反斜線。

Example #2 在 date() 中轉義字符

<?php // prints something like: Wednesday the 15th echo date("l \the jS"); ?>

能夠把 date() 和 mktime() 結合使用來獲得將來或過去的日期。

Example #3 date() 和 mktime() 例子

<?php $tomorrow = mktime(0, 0, 0, date("m") , date("d")+1, date("Y")); $lastmonth = mktime(0, 0, 0, date("m")-1, date("d"), date("Y")); $nextyear = mktime(0, 0, 0, date("m"), date("d"), date("Y")+1); ?>

Note:

因爲夏令時的緣故，這種方法比簡單地在時間戳上加減一天或者一個月的秒數更可靠。

一些使用 date() 格式化日期的例子。注意要轉義全部其它的字符，由於目前有特殊含義的字符會產生不須要的結果，而其他字符在 PHP 未來的版本中可能會被用上。當轉義時，注意用單引號以免相似 的字符變成了換行符。

Example #4 date() 格式舉例

<?php // 假定今天是：March 10th, 2001, 5:16:18 pm $today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm $today = date("m.d.y"); // 03.10.01 $today = date("j, n, Y"); // 10, 3, 2001 $today = date("Ymd"); // 20010310 $today = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6 Fripm01 $today = date('i is he jS day.'); // It is the 10th day. $today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001 $today = date('H:m:s m is mo h'); // 17:03:17 m is month $today = date("H:i:s"); // 17:16:17 ?>

要格式化其它語種的日期，應該用 setlocale() 和 strftime() 函數來代替 date()。

參見 getlastmod()，gmdate()，mktime()，strftime() 和 time()。