指定した日付に関する詳細な情報を連想配列で返す

# date_parse

(PHP 5 >= 5.2.0, PHP 7)

date_parse — 指定した日付に関する詳細な情報を連想配列で返す

### 説明

date_parse ( string `$date` ) : array

### パラメータ

`date`

  strtotime() が理解できる書式の日付。

### 返り値

成功した場合に日付情報を含む配列、失敗した場合に `FALSE` を返します。

### エラー / 例外

日付フォーマットにエラーがある場合は、 'errors' 要素にエラーメッセージが格納されます。

### 例

例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
            )

    )

### 参考

- checkdate() - グレゴリオ暦の日付/時刻の妥当性を確認します
- getdate() - 日付/時刻情報を取得する