# date_parse

(PHP 5 >= 5.2.0, PHP 7)

date_parse — Returns associative array with detailed info about given date/time

### Description

date_parse ( string `$datetime` ) : array|false

### Parameters

`datetime`

  Date/time in format accepted by DateTimeImmutable::__construct().

### Return Values

Returns array with information about the parsed date/time on success or `FALSE` on failure.

### Errors/Exceptions

In case the date/time format has an error, the element 'errors' will contains the error messages.

### Changelog

Version | Description
--- | ---
7.2.0 | The `zone` element of the returned array represents seconds instead of minutes now, and its sign is inverted. For instance `-120` is now `7200`.

### Examples

Example #1 A date_parse() example

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

The above example will output:

    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 formats do not influence the values parsed from absolute formats, but are parsed into the "relative" element.

Example #2 date_parse() with relative formats

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

The above example will output:

    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
            )

    )

### See Also

- checkdate() - Validate a Gregorian date
- getdate() - Get date/time information