百科狗strftime() - php 日期时间函数
strftime()
(PHP 4, PHP 5, PHP 7)
根据区域设置格式化本地时间／日期
说明
strftime(string $format[,int $timestamp= time()]): string返回用给定的格式字串对给出的$timestamp进行格式输出后的字符串。如果没有给出时间戳则用当前的本地时间。月份和星期几以及其它和语言有关的字符串写法和用setlocale()设定的当前的区域有关。
可能不是所有的转换标记都被 C 库文件支持，这种情况下 PHP 的strftime()也不支持。此外，不是所有的平台都支持负的时间戳，因此日期的范围可能限定在不早于 Unix 纪元。这意味着例如%e,%T，%R 和%D（可能更多）以及早于Jan 1, 1970的时间在 Windows，一些 Linux 发行版本，以及其它几个操作系统中无效。对于 Windows 系统，所支持的转换标记可在»MSDN网站找到。
参数
$format格式 | 描述 | 返回值示例 |
|---|---|---|
| 日 | --- | --- |
| %a | 当前区域星期几的简写 | Sun到Sat |
| %A | 当前区域星期几的全称 | Sunday到Saturday |
| %d | 月份中的第几天，十进制数字（范围从 01 到 31） | 01到31 |
| %e | 月份中的第几天，十进制数字，一位的数字前会加上一个空格（范围从' 1'到'31'）在 Windows 上尚未按描述实现。更多信息见下方。 | 1到31 |
| %j | 年份中的第几天，带前导零的三位十进制数（范围从 001 到 366） | 001到366 |
| %u | 符合 ISO-8601 星期几的十进制数表达[1,7]，1 表示星期一 | 1(星期一)到7(星期日) |
| %w | 星期中的第几天，星期天为 0 | 0(星期天)到6(星期六) |
| 周 | --- | --- |
| %U | 本年的第几周，从第一周的第一个星期天作为第一天开始 | 13(for the 13th full week of the year) |
| %V | %V -本年第几周的 ISO-8601:1988 格式，范围从 01 到 53，第 1 周是本年第一个至少还有 4 天的星期，星期一作为每周的第一天。（用%G 或者%g 作为指定时间戳相应周数的年份组成。） | 01到53(where 53 accounts for an overlapping week) |
| %W | 本年的第几周数，从第一周的第一个星期一作为第一天开始 | 46(for the 46th week of the year beginning with a Monday) |
| 月 | --- | --- |
| %b | 当前区域月份的简写 | Jan到Dec |
| %B | 当前区域月份的全称 | January到December |
| %h | 当前区域月份的简写（%b 的别名） | Jan到Dec |
| %m | 两位数的月份 | 01(是一月份)到12(是十二月份) |
| 年 | --- | --- |
| %C | 两位数显示世纪（年份除以 100，截成整数） | 19是 20 世纪 |
| %g | 2 位数的年份，符合 ISO-8601:1988 星期数（参见%V）。和%V 的格式和值一样，只除了如果 ISO 星期数属于前一年或者后一年，则使用那一年。 | 比如：2009年1月6日那一周是09。 |
| %G | %g 的完整四位数版本 | 比如：2009年1月3日那一周是2008. |
| %y | 两位数显示年份 | 比如：09是 2009，79是 1979 |
| %Y | 四位数显示年份 | 比如：2038 |
| 时间 | --- | --- |
| %H | 以 24 小时格式显示两位小时数 | 00到23 |
| %I | 以 12 小时格式显示两位小时数 | 01到12 |
| %l（'L'的小写） | 以 12 小时格式显示小时数，单个数字前含空格 | 1到12 |
| %M | 两位的分钟数 | 00到59 |
| %p | 指定时间的大写“AM”或“PM” | 比如： 00:31 是AM，22:23 是PM |
| %P | 指定时间的小写“am”或“pm” | 比如：00:31 是am，22:23 是pm |
| %r | 和"%I:%M:%S %p"一样 | 比如： 21:34:17 是09:34:17 PM |
| %R | 和"%H:%M"一样 | 比如： 12:35 AM 是00:35，4:44 PM 是16:44 |
| %S | 两位数字表示秒 | 00到59 |
| %T | 和"%H:%M:%S"一样 | 比如： 09:34:17 PM 是21:34:17 |
| %X | 当前区域首选的时间表示法，不包括日期 | 例如：03:59:16或15:59:16 |
| %z | 从 UTC 的时区偏移或简写（由操作系统决定） | 比如：东部时间是-0500或EST |
| %Z | %z 没有给出的 UTC 的时区偏移或简写（由操作系统决定） | 比如：-0500或EST是东部时间 |
| 时间和日期戳 | --- | --- |
| %c | 当前区域首选的日期时间表达 | 比如： 2009 年 2 月 5 日上午 12:45:10 是Tue Feb 5 00:45:10 2009 |
| %D | 和"%m/%d/%y"一样 | 比如： 2009 年 2 月 5 日是02/05/09 |
| %F | Same as "%Y-%m-%d"(commonly used in database datestamps) | 比如：2009 年 2 月 5 日是2009-02-05 |
| %s | Unix纪元的时间戳（和time()函数一样） | 比如： 1979 年 9 月 10 日上午 8 点 40 分 00 秒是305815200 |
| %x | 当前区域首选的时间表示法，不包括时间 | 比如： 2009 年 2 月 5 日是02/05/09 |
| 其他 | --- | --- |
| %n | 换行符("n") | --- |
| %t | Tab 字符("t") | --- |
| %% | 文字上的百分字符("%") | --- |
这个参数的最大长度是 1023 个字符。
Warning尽管 ISO 9889:1999（当前的 C 标准）明确指出一周从星期一开始，但是 Sun Solaris 的一周似乎从星期天开始并作为 1。所以%u 的结果也许不会和手册里描述得一样。
Warning仅针对 Windows：这个函数里%e修饰符修饰符还不能支持 Windows。为了得到这个值可以用%#d修饰符来代替。下例说明了如何写一个跨平台支持的函数。
Warning仅针对 Mac OS X：这个函数里%P修饰符还不能支持 Mac OS X。
$timestamp可选的$timestamp参数是一个integer的 Unix时间戳，如未指定，参数值默认为当前本地时间。也就是说，其值默认为time()的返回值。
返回值
根据指定的$timestamp或未给出 timestamp 是使用当前本地时间，返回$format格式化的字符。月份、星期名和其他与语言相关的字符串遵守setlocale()设置的当前区域设置。
错误／异常
在每次调用日期/时间函数时，如果时区无效则会引发E_NOTICE错误，如果使用系统设定值或TZ环境变量，则会引发E_STRICT或E_WARNING消息。参见date_default_timezone_set()。
由于输出依赖于 C 库，所以一些转换标记并不被支持。在 Windows 上，使用未知的转换标记将导致5E_WARNING信息，并返回FALSE。在其他的操作系统上，你可能不能得到任何E_WARNING信息，并且可能输出未经转换的转换标记。
更新日志
| 版本 | 说明 |
|---|---|
| 5.1.0 | 现在发布 |
范例
如果你的系统里安装了各自的语言环境则下例能够正常运行。
Example #1strftime()区域的例子
ISO 8601:1988 week number example
Example #3%e修改器跨平台兼容的例子
显示所有已知和未知的格式
鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com
图片声明：本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!
