date
(PHP 4, PHP 5, PHP 7)
date — 格式化一个本地时间/日期
说明 ¶
$format
[, int $timestamp
] )返回将整数 timestamp
按照给定的格式字串而产生的字符串。如果没有给出时间戳则使用本地当前时间。换句话说,timestamp
是可选的,默认值为 time()。
自 PHP 5.1.1 起有几个有用的常量可用作标准的日期/时间格式来指定 format
参数。
自 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 字符 | 说明 | 返回值例子 |
---|---|---|
日 | --- | --- |
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() |
格式字串中不能被识别的字符将原样显示。Z 格式在使用 gmdate() 时总是返回 0。
PHP中的日期和时间主要是靠 date() 函数来获取并格式化的,虽说这东西使用频率非常高,但有时也会忘记或搞混,故现小结如下...
一、年/月/日
1、年
Y(2010):大写Y表示年四位数字
y(10) :小写y表示年的两位数字
2、月
F(January):大写F表示月份的英文全写(没有小写f)
M(Jan) :大写M表示月份的3个缩写字符
m(01-12) :小写m表示月份的数字,带前导
n(1-12) :小写n表示月份的数字,无前导
3、日
j(1-31) :小写j表示月份的日期,无前导(没有大写的J)
d(01-31) :小写d表示月份的日期,有前导(没有大写D)
S(st、nd、rd、th):大写S表示日期的后缀,具体看日期数字为何
4、实例
Y-m-j(2007-02-6 )
y-n-j(07-2-6)
Y-M-j(2007-Feb-6)
Y-m-d(2007-02-06)
Y-F-jS(2007-February-6th)
二、时:分:秒
1、时
g(1-12):小写g表示12小时制的小时数,无前导0
h(01-12):小写h表示12小时制的小时数,有前导0
G(0-23):大写G表示24小时制的小时数,无前导0
H(01-23):大写的H表示24小时制的小时数,有前导0
a 表示小写的"am"和"pm"(上午、下午)
A 表示大写的"AM"和"PM"
2、分:秒
默认情况下,PHP解释显示的时间为"格林威治标准时间",与我们本地的时间相差8个小时。
i(1-60):小写i表示分
s(1-60):小写s表示秒
3、实例
g:i:s a(5:56:57 am)
h:i:s A(05:56:57 AM)
G:i:s(14:02:26)
三、闰年、星期、天
- 大写L表示判断今年是否闰年,布尔值,为真返回1,否则为0
- 小写w表示星期几,数字形式表示
- 大写W表示一年中的星期数
- 小写t表示当前月份有多少天
- 小写z表示今天是本年中第几天
四、其他
- 大写T表示服务器的时间区域设置,如值为UTC
- 大写I表示判断当前是否为夏令时,为真返回1,否则为0
- 大写U表示从1970年1月1日到现在的总秒数,就是Unix时间纪元的UNIX时间戳。
- 小写c表示ISO8601日期,日期格式为YYYY-MM-DD,用字母T来间隔日期和时间,时间格式为HH:MM:SS,时区使用格林威治标准时间(GMT)的偏差来表示,如值为2007-02-06T14:24:43+00:00
- 小写r表示RFC822日期,如值为Tue, 06 Feb 2007 14:25:52 +0000
- 顶
- 0