date()

(PHP 4, PHP 5, PHP 7)

格式化一个本地时间／日期

说明

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

自 PHP 5.1.1 起有几个有用的常量可用作标准的日期／时间格式来指定$format参数。

自 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 日。Note:

要将字符串表达的时间转换成时间戳，应该使用strtotime()。此外一些数据库有一些函数将其时间格式转换成时间戳（例如 MySQL 的» UNIX_TIMESTAMP函数）。

格式字串中不能被识别的字符将原样显示。Z格式在使用gmdate()时总是返回0。

Example #1date()例子

在格式字串中的字符前加上反斜线来转义可以避免它被按照上表解释。如果加上反斜线后的字符本身就是一个特殊序列，那还要转义反斜线。

在date()中转义字符

可以把date()和mktime()函数结合使用来得到未来或过去的日期。

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

由于夏令时的缘故，这种方法比简单地在时间戳上加减一天或者一个月的秒数更可靠。

一些使用date()格式化日期的例子。注意要转义所有其它的字符，因为目前有特殊含义的字符会产生不需要的结果，而其余字符在 PHP 将来的版本中可能会被用上。当转义时，注意用单引号以避免类似n 的字符变成了换行符。

Example #4date()格式举例

要格式化其它语种的日期，应该用setlocale()和strftime()函数来代替date()。

参见getlastmod()，gmdate()，mktime()，strftime()和time()。

参数

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

格式化字符串中的不可识别字符将原样输出。当使用gmdate()函数时，Z格式永远返回0。

由于本函数仅接受integer类型的时间戳参数，所以u格式仅在使用date_format()函数并且使用date_create()函数创建时间戳时才是有用的。$timestamp

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

返回值

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

错误／异常

在每次调用日期/时间函数时，如果时区无效则会引发E_NOTICE错误，如果使用系统设定值或TZ环境变量，则会引发E_STRICT或E_WARNING消息。参见date_default_timezone_set()。

更新日志

范例

Example #5date()函数示例

可以使用反斜线进行转义来阻止函数解析格式字符串中的可识别字符。如果反斜线和要转义的字符连在一起依然是一个有效的字符序列，那么需要对反斜线再次进行转义。

对date()函数中的格式字符串进行转义

可以联合使用date()和mktime()函数来构造之前或者之后的日期时间。

Example #7date()和mktime()联合使用示例

由于存在夏令时时间，所以此方案相对于直接在时间戳上加/减秒数要更加可靠。

date()函数格式化的一些示例。需要注意的是，即使是对于当前来说并不具有特殊含义的字符，也要像对待具有特殊含义的字符那样进行转义，以避免函数返回非预期的值。因为可能在将来的 PHP 版本中，这些字符会被赋予特殊的含义。进行转义的时候，请确保使用单引号，以避免n 被解释为换行符号。

Example #8date()函数格式化

如果需要将日期时间格式化为其他语言，你应该使用setlocale()和strftime()函数来替代date()函数。

注释

使用strtotime()函数将一个字符串表达的日期时间转换为时间戳。另外，一些数据库产品也提供了将日期时间格式转换为时间戳的函数。（例如 MySQL 中的» UNIX_TIMESTAMP函数）。Tip

从 PHP 5.1 版本开始，请求的开始时间可以从变量$_SERVER['REQUEST_TIME']中获取。

参见

• gmdate() 格式化一个 GMT/UTC 日期／时间
• idate() 将本地时间日期格式化为整数
• getdate() 取得日期／时间信息
• getlastmod() 获取页面最后修改的时间
• mktime() 取得一个日期的 Unix 时间戳
• strftime() 根据区域设置格式化本地时间／日期
• time() 返回当前的 Unix 时间戳
• strtotime() 将任何字符串的日期时间描述解析为 Unix 时间戳
• 预定义的日期时间常量

Things to be aware of when using week numbers with years.

BUT

Reason:
Y is year from the date
o is ISO-8601 year number
W is ISO-8601 week number of year
Conclusion:
if using 'W' for the week number use 'o' for the year.

For Microseconds, we can get by following:
echo date('Ymd His'.substr((string)microtime(), 1, 8).' e');
Thought, it might be useful to someone !

Prior to PHP 5.6.23, Relative Formats for the start of the week aligned with PHP's (0=Sunday,6=Saturday). Since 5.6.23, Relative Formats for the start of the week align with ISO-8601 (1=Monday,7=Sunday). (http://php.net/manual/en/datetime.formats.relative.php)
This can produce different, and seemingly incorrect, results depending on your PHP version and your choice of 'w' or 'N' for the Numeric representation of the day of the week: 
 
Prior to PHP 5.6.23, this results in: 
Today is Sun 2 Oct 2016, day 0 of this week. Day 1 of next week is 10 Oct 2016
Today is Sun 2 Oct 2016, day 7 of this week. Day 1 of next week is 10 Oct 2016
Since PHP 5.6.23, this results in: 
Today is Sun 2 Oct 2016, day 0 of this week. Day 1 of next week is 03 Oct 2016
Today is Sun 2 Oct 2016, day 7 of this week. Day 1 of next week is 03 Oct 2016

For HTML5 datetime-local HTML input controls (http://www.w3.org/TR/html-markup/input.datetime-local.html) use format example: 1996-12-19T16:39:57
To generate this, escape the 'T', as shown below: 

this how you make an HTML5  tag correctly

in the "datetime" attribute you should put a machine-readable value which represent time , the best value is a full time/date with ISO 8601 ( date('c') ) ,,, the attr will be hidden from users
and it doesn't really matter what you put as a shown value to the user,, any date/time format is okay !
This is very good for SEO especially search engines like Google .

If timestamp is a string, date converts it to an integer in a possibly unexpected way:

(PHP 5.6.16)

It's common for us to overthink the complexity of date/time calculations and underthink the power and flexibility of PHP's built-in functions. Consider http://php.net/manual/en/function.date.php#108613

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com