date() - php 日期时间函数
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字符 | 说明 | 返回值例子 |
---|---|---|
日 | --- | --- |
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:1999or2003 |
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。
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字符 | 描述 | 返回值示例 |
---|---|---|
天 | --- | --- |
d | 一个月中的第几天,有前导 0 的 2 位数字 | 从01到31 |
D | 3 个字符表示的星期几 | 从Mon到Sun |
j | 一个月中的第几天,无前导 0 | 从1到31 |
l(lowercase 'L') | 星期几,英文全称 | 从Sunday到Saturday |
N | ISO-8601 规定的数字表示的星期几(PHP 5.1.0 新加) | 从1(表示星期一)到7(表示星期日) |
S | 一个月中的第几天,带有 2 个字符表示的英语序数词。 | st,nd,rd或者th。可以和j联合使用。 |
w | 数字表示的星期几 | 从0(星期日)到6(星期六) |
z | 一年中的第几天,从 0 开始计数 | 从0到365 |
周 | --- | --- |
W | ISO-8601 规范的一年中的第几周,周一视为一周开始。(PHP 4.1.0 新加) | 示例:42(本年第42周) |
月 | --- | --- |
F | 月份英文全拼,例如:January 或 March | 从January到December |
m | 带有 0 前导的数字表示的月份 | 从01到12 |
M | 3 个字符表示的月份的英文简拼 | 从Jan到Dec |
n | 月份的数字表示,无前导0 | 1through12 |
t | 给定月份中包含多少天 | 从28到31 |
年 | --- | --- |
L | 是否为闰年 | 如果是闰年,则返回1,反之返回0。 |
o | ISO-8601 规范的年份,同Y格式。有一种情况除外:当 ISO 的周数(W)属于前一年或者后一年时,会返回前一年或者后一年的年份数字表达。属于前一年或者后一年时,会返回前一年或者后一年的年份数字表达。(PHP 5.1.0 新加) | 示例:1999或2003 |
Y | 4 位数字的年份 | 示例:1999或2003 |
y | 2 位数字的年份 | 示例:99或03 |
时间 | --- | --- |
a | 上午还是下午,2 位小写字符 | am或pm |
A | 上午还是下午,2 位大写字符 | AM或PM |
B | 斯沃琪因特网时间 | 从000到999 |
g | 小时,12时制,无前导0 | 从1到12 |
G | 小时,24时制,无前导0 | 从0到23 |
h | 小时,12时制,有前导 0 的 2 位数字 | 从01到12 |
H | 小时,24时制,有前导 0 的 2 位数字 | 00through23 |
i | 分钟,有前导 0 的 2 位数字 | 从00到59 |
s | 秒,有前导 0 的 2 位数字 | 从00到59 |
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 以东的时区返回正数。 | 从-43200到50400 |
完整的日期/时间 | --- | --- |
c | ISO 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()的返回值。
返回值
返回格式化后的日期时间的字符串表达。如果$timestamp参数不是一个有效数值,则返回FALSE
并引发E_WARNING
级别的错误。
错误/异常
在每次调用日期/时间函数时,如果时区无效则会引发E_NOTICE
错误,如果使用系统设定值或TZ环境变量,则会引发E_STRICT
或E_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 | 现在发布 |
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
图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!