百科狗-知识改变命运!
--

date() - php 日期时间函数

梵高1年前 (2023-11-21)阅读数 15#技术干货
文章标签时间

date()

(PHP 4, PHP 5, PHP 7)

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

说明

date(string $format[,int $timestamp]): string

返回将整数$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 位数字0131
D星期中的第几天,文本表示,3 个字母MonSun
j月份中的第几天,没有前导零131
l(“L”的小写字母)星期几,完整的文本格式SundaySaturday
NISO-8601 格式数字表示的星期中的第几天(PHP 5.1.0 新加)1(表示星期一)到7(表示星期天)
S每月天数后面的英文后缀,2 个字符stndrd或者th。可以和j一起用
w星期中的第几天,数字表示0(表示星期天)到6(表示星期六)
z年份中的第几天0365
星期------
WISO-8601 格式年份中的第几周,每周从星期一开始(PHP 4.1.0 新加的)例如:42(当年的第 42 周)
------
F月份,完整的文本格式,例如 January 或者 MarchJanuaryDecember
m数字表示的月份,有前导零0112
M三个字母缩写表示的月份JanDec
n数字表示的月份,没有前导零112
t指定的月份有几天2831
------
L是否为闰年如果是闰年为1,否则为0
oISO-8601 格式年份数字。这和Y的值相同,只除了如果 ISO 的星期数(W)属于前一年或下一年,则用那一年。(PHP 5.1.0 新加)Examples:1999or2003
Y4 位数字完整表示的年份例如:19992003
y2 位数字表示的年份例如:9903
时间------
a小写的上午和下午值ampm
A大写的上午和下午值AMPM
BSwatch Internet 标准时000999
g小时,12 小时格式,没有前导零112
G小时,24 小时格式,没有前导零023
h小时,12 小时格式,有前导零0112
H小时,24 小时格式,有前导零0023
i有前导零的分钟数0059>
s秒数,有前导零0059>
u毫秒(PHP 5.2.2 新加)。需要注意的是date()函数总是返回000000因为它只接受integer参数,而DateTime::format()才支持毫秒。示例:654321
时区------
e时区标识(PHP 5.1.0 新加)例如:UTCGMTAtlantic/Azores
I是否为夏令时如果是夏令时为1,否则为0
O与格林威治时间相差的小时数例如:+0200
P与格林威治时间(GMT)的差别,小时和分钟之间有冒号分隔(PHP 5.1.3 新加)例如:+02:00
T本机所在的时区例如:ESTMDT(【译者注】在 Windows 下为完整文本格式,例如“Eastern Standard Time”,中文版会显示“中国标准时间”)。
Z时差偏移量的秒数。UTC 西边的时区偏移量总是负的,UTC 东边的时区偏移量总是正的。-4320043200
完整的日期/时间------
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()

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

Example #1date()例子

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

date()中转义字符

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

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

Note:

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

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

Example #4date()格式举例

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

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

参数

$format

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

$format参数字符串中可识别下列字符
$format字符描述返回值示例
------
d一个月中的第几天,有前导 0 的 2 位数字0131
D3 个字符表示的星期几MonSun
j一个月中的第几天,无前导 0131
l(lowercase 'L')星期几,英文全称SundaySaturday
NISO-8601 规定的数字表示的星期几(PHP 5.1.0 新加)1(表示星期一)到7(表示星期日)
S一个月中的第几天,带有 2 个字符表示的英语序数词。stndrd或者th。可以和j联合使用。
w数字表示的星期几0(星期日)到6(星期六)
z一年中的第几天,从 0 开始计数0365
------
WISO-8601 规范的一年中的第几周,周一视为一周开始。(PHP 4.1.0 新加)示例:42(本年第42周)
------
F月份英文全拼,例如:January 或 MarchJanuaryDecember
m带有 0 前导的数字表示的月份0112
M3 个字符表示的月份的英文简拼JanDec
n月份的数字表示,无前导01through12
t给定月份中包含多少天2831
------
L是否为闰年如果是闰年,则返回1,反之返回0
oISO-8601 规范的年份,同Y格式。有一种情况除外:当 ISO 的周数(W)属于前一年或者后一年时,会返回前一年或者后一年的年份数字表达。属于前一年或者后一年时,会返回前一年或者后一年的年份数字表达。(PHP 5.1.0 新加)示例:19992003
Y4 位数字的年份示例:19992003
y2 位数字的年份示例:9903
时间------
a上午还是下午,2 位小写字符ampm
A上午还是下午,2 位大写字符AMPM
B斯沃琪因特网时间000999
g小时,12时制,无前导0112
G小时,24时制,无前导0023
h小时,12时制,有前导 0 的 2 位数字0112
H小时,24时制,有前导 0 的 2 位数字00through23
i分钟,有前导 0 的 2 位数字0059
s秒,有前导 0 的 2 位数字0059
u毫秒(PHP 5.2.2 新加)示例:654321
时区------
e时区标识(PHP 5.1.0 新加)示例:UTC,GMT,Atlantic/Azores
I(大写字母 i)是否夏令时如果是夏令时则返回1,反之返回0
O和格林威治时间(GMT)的时差,以小时为单位示例:+0200
P和格林威治时间(GMT)的时差,包括小时和分钟,小时和分钟之间使用冒号(:)分隔(PHP 5.1.3 新加)示例:+02:00
T时区缩写示例:EST,MDT...
Z以秒为单位的时区偏移量。UTC 以西的时区返回负数,UTC 以东的时区返回正数。-4320050400
完整的日期/时间------
cISO 8601 日期及时间(PHP 5 新加)2004-02-12T15:19:21+00:00
r» RFC 2822格式的日期和时间示例:Thu, 21 Dec 2000 16:01:07 +0200
U自 1970 年 1 月 1 日 0 时 0 分 0 秒(GMT 时间)以来的时间,以秒为单位参见time()

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

Note:

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

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

返回值

date() - php 日期时间函数

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

错误/异常

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

更新日志

版本说明
5.1.0时间戳的有效取值范围为 GMT 时间的 1901 年 12 月 13 日至 GMT 时间的 2038 年 1 月 19 日。(32 位有符号整数的取值范围)。但是,在 PHP 5.1.0 之前的版本,在某些系统(例如 Windows)上有效取值范围为 1970 年 1 月 1 日至 2038 年 1 月 19 日。
5.1.0

现在发布E_STRICTE_NOTICE时区错误。

5.1.1$format参数标准的可用日期/时间格式常量见:常量

范例

Example #5date()函数示例

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

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

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

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

Note:

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

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

Example #8date()函数格式化

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

注释

Note:

使用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

免责声明:我们致力于保护作者版权,注重分享,当前被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理!邮箱:344225443@qq.com)

图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!

内容声明:本文中引用的各种信息及资料(包括但不限于文字、数据、图表及超链接等)均来源于该信息及资料的相关主体(包括但不限于公司、媒体、协会等机构)的官方网站或公开发表的信息。部分内容参考包括:(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供参考使用,不准确地方联系删除处理!本站为非盈利性质站点,本着为中国教育事业出一份力,发布内容不收取任何费用也不接任何广告!)