date_parse

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

date_parse — 返回指定日期/时间的详细信息的关联数组

说明

date_parse(string $datetime): array

参数

datetime

Date/time 接受的格式以 DateTimeImmutable::__construct() 为准。

返回值

成功时返回 array，数组中包含指定日期/时间的信息。 或者在失败时返回 false。

错误／异常

如果 date/time 的格式有错误，则返回数组的 'errors' 键将包含错误信息。

更新日志

版本 说明
7.2.0 返回数组的 zone 键现在代表秒，而不是分钟。 并且正负符号已反转，例如：之前是 -120 现在是 7200。

范例

示例 #1 date_parse() 示例

<?php
print_r(date_parse("2006-12-12 10:00:00.5"));
?>

以上例程会输出：

Array
(
    [year] => 2006
    [month] => 12
    [day] => 12
    [hour] => 10
    [minute] => 0
    [second] => 0
    [fraction] => 0.5
    [warning_count] => 0
    [warnings] => Array()
    [error_count] => 0
    [errors] => Array()
    [is_localtime] =>
)

解析后返回的关联数组不受 相对格式 影响，相对格式的信息会被解析到 "relative" 键。

示例 #2 date_parse() 使用相对格式

<?php
print_r(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>

以上例程会输出：

Array
(
    [year] => 2006
    [month] => 12
    [day] => 12
    [hour] => 10
    [minute] => 0
    [second] => 0
    [fraction] => 0.5
    [warning_count] => 0
    [warnings] => Array
        (
        )

    [error_count] => 0
    [errors] => Array
        (
        )

    [is_localtime] =>
    [relative] => Array
        (
            [year] => 0
            [month] => 0
            [day] => 7
            [hour] => 1
            [minute] => 0
            [second] => 0
        )

)

参见