技术笔记

外观

date函数

约 2648 字大约 9 分钟

2025-06-19

定义和用法

date() 函数格式化本地日期和时间，并返回已格式化的日期字符串。

语法

date(format,timestamp);

返回将整数timestamp按照给定的格式字串而产生的字符串。
如果没有给出时间戳则使用本地当前时间。换句话说，timestamp是可选的，默认值为time()。

自 PHP 5.1 起在 $_SERVER['REQUEST_TIME'] 中保存了发起该请求时刻的时间戳。

注意

有效的时间戳典型范围是格林威治时间 1901 年 12 月 13 日 20:45:54 到 2038 年 1 月 19 日 03:14:07。（此范围符合 32 位有符号整数的最小值和最大值）。不过在 PHP 5.1 之前此范围在某些系统（如 Windows）中限制为从 1970 年 1 月 1 日到 2038 年 1 月 19 日。

参数

format
输出的日期 string 格式。 参见下文中的 格式化选项。 同时，还可以使用 预定义日期常量 ，例如：常量 DATE_RSS 表示格式化字符串 'D, d M Y H:i:s'。

format字符说明返回值例子
日
d月份中的第几天，有前导零的 2 位数字01 到 31
D星期中的第几天，文本表示，3 个字母Mon 到 Sun
j月份中的第几天，没有前导零1 到 31
l（“L”的小写字母）星期几，完整的文本格式Sunday 到 Saturday
NISO-8601 格式数字表示的星期中的第几天（PHP 5.1.0 新加）1（表示星期一）到 7（表示星期天）
S每月天数后面的英文后缀，2 个字符st，nd，rd 或者 th。可以和 j 一起用
w星期中的第几天，数字表示0（表示星期天）到 6（表示星期六）
z年份中的第几天0 到 365
星期
WISO-8601 格式年份中的第几周，每周从星期一开始（PHP 4.1.0 新加的）例如：42（当年的第 42 周）
月
F月份，完整的文本格式，例如 January 或者 MarchJanuary 到 December
m数字表示的月份，有前导零01 到 12
M三个字母缩写表示的月份Jan 到 Dec
n数字表示的月份，没有前导零1 到 12
t指定的月份有几天28 到 31
年
L是否为闰年如果是闰年为 1，否则为 0
oISO-8601 格式年份数字。这和 Y 的值相同，只除了如果 ISO 的星期数（W）属于前一年或下一年，则用那一年。（PHP 5.1.0 新加）Examples: 1999 or 2003
Y4 位数字完整表示的年份例如：1999 或 2003
y2 位数字表示的年份例如：99 或 03
时间
a小写的上午和下午值am 或 pm
A大写的上午和下午值AM 或 PM
BSwatch 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
完整的日期／时间
cISO 8601 格式的日期（PHP 5 新加）2004-02-12T15:19:21+00:00
rRFC 822 格式的日期例如：Thu, 21 Dec 2000 16:01:07 +0200
U从 Unix 纪元（January 1 1970 00:00:00 GMT）开始至今的秒数参见 time()
预定义常量（从 PHP 5.1.0 开始可用）
DATE_ATOMAtom例如：2013-04-12T15:52:01+00:00
DATE_COOKIEHTTP Cookies例如：Friday, 12-Apr-13 15:52:01 UTC
DATE_ISO8601ISO-8601例如：2013-04-12T15:52:01+0000
DATE_RFC822RFC 822例如：Fri, 12 Apr 13 15:52:01 +0000
DATE_RFC850RFC 850例如：Friday, 12-Apr-13 15:52:01 UTC
DATE_RFC1036RFC 1036例如：Fri, 12 Apr 13 15:52:01 +0000
DATE_RFC1123RFC 1123例如：Fri, 12 Apr 2013 15:52:01 +0000
DATE_RFC2822RFC 2822Fri, 12 Apr 2013 15:52:01 +0000
DATE_RFC3339与 DATE_ATOM 相同从 PHP 5.1.3 开始
DATE_RSSRSSFri, 12 Aug 2013 15:52:01 +0000
DATE_W3C万维网联盟例如：2013-04-12T15:52:01+00:00
格式字串中不能被识别的字符将原样显示。Z 格式在使用 gmdate() 时总是返回 0。

timestamp
可选的 timestamp 参数是一个 int 的 Unix 时间戳，如未指定或是 null，参数值默认为当前本地时间。也就是说，其值默认为 time() 的返回值

返回值

返回格式化后的日期时间的字符串表达。 如果 timestamp 参数不是一个有效数值，则返回 false 并引发 E_WARNING 级别的错误。

其它函数

checkdate(month,month,date,$year)

如果应用的值构成一个有效日期，则该函数返回为真。
例如，对于错误日期2005年2月31日，此函数返回为假。
在日期用于计算或保存在数据库中之前，可用此函数检查日期并使日期生效。

<?php
// returns false
echo checkdate(2,30,2005) ? "valid" : "invalid";
// returns true
echo checkdate(4,6,2010) ? "valid" : "invalid";
?>

getdate($ts)

在没有自变量的情况下，该函数以结合数组的方式返回当前日期与时间。数组中的每个元素代表日期/时间值中的一个特定组成部分。可向函数提交可选的时间标签自变量，以获得与时间标签对应的日期/时间值。
应用此函数来获得一系列离散的，容易分离的日期/时间值。

<?php
// get date as associative array
$arr = getdate();
echo "Date is " . $arr['mday'] . " " . $arr['weekday'] . " " . $arr['year'];
echo "Time is " . $arr['hours'] . ":" . $arr['minutes'];
?>

mktime($hour, $minute, $second, $month, $day, $year)

此函数的作用与getdate()的作用相反：它由一系列的日期与时间值生成一个UNIX时间标签（GMT时间1970年1月1日到现在消逝的秒数）。不用自变量时，它生成当前时间的UNIX时间标签。
用此函数获得即时时间的UNIX时间标签。这种时间标签通常用于许多数据库与程序语言中。

<?php
// returns timestamp for 13:15:23 7-Jun-2006
echo mktime(13,15,23,6,7,2006);
?>

令人困惑的strtotime

经常会有人被strtotime结合-1 month, +1 month, next month的时候搞得很困惑, 然后就会觉得这个函数有点不那么靠谱, 动不动就出问题. 用的时候就会很慌…

比如:

举例

今天是2018-07-31
执行代码:

date("Y-m-d",strtotime("-1 month"))

怎么输出是2018-07-01?

好的吧, 虽然这个问题看起来很迷惑, 但从内部逻辑上来说呢, 其实是”对”的, 你先别着急哈, 让我慢慢讲:

我们来模拟下date内部的对于这种事情的处理逻辑:

  1. 先做-1 month, 那么当前是07-31, 减去一以后就是06-31.

  2. 再做日期规范化, 因为6月没有31号, 所以就好像2点60等于3点一样, 6月31就等于了7月1

是不是逻辑很”清晰”呢? 我们也可以手动验证第二个步骤, 比如:

var_dump(date("Y-m-d", strtotime("2017-06-31")));//输出2017-07-01

也就是说, 只要涉及到大小月的最后一天, 都可能会有这个迷惑, 我们也可以很轻松的验证类似的其他月份, 印证这个结论:

var_dump(date("Y-m-d", strtotime("-1 month", strtotime("2017-03-31"))));//输出2017-03-03
var_dump(date("Y-m-d", strtotime("+1 month", strtotime("2017-08-31"))));//输出2017-10-01
var_dump(date("Y-m-d", strtotime("next month", strtotime("2017-01-31"))));//输出2017-03-03
var_dump(date("Y-m-d", strtotime("last month", strtotime("2017-03-31"))));//输出2017-03-03

那怎么办呢?

从PHP5.3开始呢, date新增了一系列修正短语, 来明确这个问题, 那就是”first day of” 和 “last day of”, 也就是你可以限定好不要让date自动”规范化”:

var_dump(date("Y-m-d", strtotime("last day of -1 month", strtotime("2017-03-31"))));//输出2017-02-28
var_dump(date("Y-m-d", strtotime("first day of +1 month", strtotime("2017-08-31"))));////输出2017-09-01
var_dump(date("Y-m-d", strtotime("first day of next month", strtotime("2017-01-31"))));////输出2017-02-01
var_dump(date("Y-m-d", strtotime("last day of last month", strtotime("2017-03-31"))));////输出2017-02-28

那如果是5.3之前的版本(还有人用么?), 你可以使用mktime之类的, 把所有的日子忽略掉, 比如都限定为每月1号就可以了, 只不过就不如直接用first day来的更加优雅.

现在, 搞清楚了内部原理, 是不是就不慌了?

转自链接：http://www.laruence.com/2018/07/31/3207.html

strtotime时间戳最大值

PHP有效的时间戳典型范围是格林威治时间1901年12月13日20:45:54到2038年1月19日03:14:07。（此范围符合32位有符号整数的最小值和最大值）。不过在PHP5.1之前此范围在某些系统（如Windows）中限制为从1970年1月1日到2038年1月19日。

当然，64位的系统是不会受此影响的。

Note

有效的时间戳通常从 Fri, 13 Dec 1901 20:45:54 GMT 到 Tue, 19 Jan 2038 03:14:07 GMT（对应于 32 位有符号整数的最小值和最大值）。不是所有的平台都支持负的时间戳，那么日期范围就被限制为不能早于 Unix 纪元。这意味着在 1970 年 1 月 1 日之前的日期将不能用在 Windows，一些 Linux 版本，以及几个其它的操作系统中。不过 PHP 5.1.0 及更新的版本克服了此限制。 —— [ PHP手册 ]

如果系统是32位的，且php版本在5.1.0之后的，可以使用new DateTime解决

$date = '2090-10-01';
$datetime = new DateTime($date);
echo '<p>正常时间: ', $datetime->format('Y-m-d H:i'), '</p>';
echo '<p>时间溢出: ', date('Y-m-d H:i', strtotime($date)), '<p>';