Php/docs/function.strptime

• PHP Manual
• Date/Time 函数
• 解析由 strftime 生成的日期／时间

strptime

(PHP 5 >= 5.1.0, PHP 7)

strptime — 解析由 strftime() 生成的日期／时间

说明

strptime ( string $date , string $format ) : array

strptime() 返回一个将 date 解析后的数组，如果出错返回 false。

月份和星期几的名字以及其它与语种有关的字符串对应于 setlocale()设定的当前区域（LC_TIME）。

参数

date（string）

被解析的字符串（例如从 strftime() 返回的）

format（string）

date 所使用的格式（例如同 strftime() 中所使用的相同）。

更多有关格式选项的信息见 strftime() 页面。

返回值

返回一个数组 或者在失败时返回 false

数组中包含以下单元

键名	说明
tm_sec	当前分钟内的秒数（0-61）
tm_min	当前小时内的分钟数（0-59）
tm_hour	午夜起的小时数（0-23）
tm_mday	月份中的第几天（1-31）
tm_mon	自一月起过了几个月（0-11）
tm_year	自 1900 年起过了几年
tm_wday	自星期天起过了几天（0-6）
tm_yday	本年自一月一日起过了多少天（0-365）
unparsed	date 中未能通过指定的 format 识别的部分

范例

Example #1 strptime() 例子

<?php$format = '%d/%m/%Y %H:%M:%S';$strf = strftime($format);echo "$strf\n";print_r(strptime($strf, $format));?>

以上例程的输出类似于：

03/10/2004 15:54:19

Array
(
    [tm_sec] => 19
    [tm_min] => 54
    [tm_hour] => 15
    [tm_mday] => 3
    [tm_mon] => 9
    [tm_year] => 104
    [tm_wday] => 0
    [tm_yday] => 276
    [unparsed] =>
)

注释

Note: 此函数未在 Windows 平台下实现。

Note:

Internally, this function calls the strptime() function provided by the system's C library. This function can exhibit noticeably different behaviour across different operating systems. The use of date_parse_from_format(), which does not suffer from these issues, is recommended on PHP 5.3.0 and later.

Note:

"tm_sec" includes any leap seconds (currently upto 2 a year). For more information on leap seconds, see the [http://en.wikipedia.org/wiki/Leap_second » Wikipedia article on leap seconds].

Note:

Prior to PHP 5.2.0, this function could return undefined behaviour. Notably, the "tm_sec", "tm_min" and "tm_hour" entries would return undefined values.

参见

• checkdate() - 验证一个格里高里日期
• strftime() - 根据区域设置格式化本地时间／日期
• date_parse_from_format() - Get info about given date formatted according to the specified format
• DateTime::createFromFormat() - 根据给定的格式解析日期时间字符串