(PHP 4, PHP 5) php
date — 格式化一個本地時間/日期 html
string date ( string $format
[, int $timestamp
] ) mysql
返回將整數 timestamp
按照給定的格式字串而產生的字符串。若是沒有給出時間戳則使用本地當前時間。換句話說,timestamp
是可選的,默認值爲 time()。 sql
Tip 數據庫
自 PHP 5.1.1 起有幾個有用的常量可用做標準的日期/時間格式來指定 format
參數。 函數
Tip .net
自 PHP 5.1 起在 $_SERVER['REQUEST_TIME'] 中保存了發起該請求時刻的時間戳。 code
Note: orm
有效的時間戳典型範圍是格林威治時間 1901 年 12 月 13 日 20:45:54 到 2038 年 1 月 19 日 03:14:07。(此範圍符合 32 位有符號整數的最小值和最大值)。不過在 PHP 5.1 以前此範圍在某些系統(如 Windows)中限制爲從 1970 年 1 月 1 日到 2038 年 1 月 19 日。server
格式字串能夠識別如下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 到 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()