date_parse

Returns associative array with detailed info about given date/time.

date_parse Function synopsis

date_parse(string $datetime): array

Parameters

$datetime

Typestring

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

Return value

Typearray

Returns array with information about the parsed date/time.

The returned array has keys for year, month, day, hour, minute, second, fraction, and is_localtime.

If is_localtime is present then zone_type indicates the type of timezone. For type 1 (UTC offset) the zone, is_dst fields are added; for type 2 (abbreviation) the fields tz_abbr, is_dst are added; and for type 3 (timezone identifier) the tz_abbr, tz_id are added.

If relative time elements are present in the $datetime string such as +3 days, the returned array includes a nested array with the key relative. This array then contains the keys year, month, day, hour, minute, second, and if necessary weekday, and weekdays, depending on the string that was passed in.

The array includes warning_count and warnings fields. The first one indicate how many warnings there were. The keys of elements warnings array indicate the position in the given $datetime where the warning occurred, with the string value describing the warning itself.

The array also contains error_count and errors fields. The first one indicate how many errors were found. The keys of elements errors array indicate the position in the given $datetime where the error occurred, with the string value describing the error itself.

The number of array elements in the `warnings` and
`errors` arrays might be less than
`warning_count` or `error_count` if they
occurred at the same position.