date_parse()

(PHP 5 >= 5.2.0, PHP 7)

Returns associative array with detailed info about given date

说明

参数

Date in format accepted bystrtotime().

返回值

Returnsarraywith information about the parsed date on success 或者在失败时返回FALSE.

错误／异常

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

更新日志

范例

Adate_parse()example

以上例程会输出：

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

Example #2date_parse()with relative formats

以上例程会输出：

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() 取得日期／时间信息

A warning to others. Some keys will return with a default value where others will return as false if the date string has it omitted. Unsure if this is a bug or feature, but hopefully this will save someone some time. 

Be aware that date_parse() is happy with just a time zone and it can be pretty counter-intuitive. E.g.:

... prints an array where year, month, day... are FALSE. But so do these:

Don't forget to further validate date_parse()'s output even when it isn't FALSE and the 'errors' key is empty.

Here is a workaround for the "Feb 2010" problem. It also handles "2014".
http://stackoverflow.com/questions/27052374/php-date-parsefeb-2010-gives-day-1/27068409

Developers, be aware that using "now" will return an empty array, ex :

Will return :
Array
(
  [year] => 
  [month] => 
  [day] => 
  [hour] => 
  [minute] => 
  [second] => 
  [fraction] => 
  [warning_count] => 0
  [warnings] => Array
    (
    )
  [error_count] => 0
  [errors] => Array
    (
    )
  [is_localtime] => 
)

Passing "YYYY-MM" results in a valid date. Be careful to validate that your submitted date passed YOUR requirements.

It's sometimes useful to be able to store incomplete dates, for example when all you know of someone's birthdate is the year or the month and day.
date_parse() handles (and MySQL accepts) dates containing zero-value elements such as "2017-00-00" and "0000-03-29", leaving it up to the parent application to determine when to require and how to handle missing date elements. date_parse() correctly reports zero values for zero-value date elements, reports an 'invalid date' warning, and does not report an error.
Example 1: Year only

generates:

Example 2: Month and day only

generates:

However, simply omitting date elements gives PHP too much discretion in second-guessing our intentions:
Example 3: Truncated date:

generates:

In this case, PHP supplies a day value of 1 and does not report a warning.
Similarly, this feature of accepting zero date elements does not carry over to timestamps:

displays:

In this case, PHP interprets the "zeroth" day of March to be the last day of February.

See checkdate() at http://php.net/manual/en/function.checkdate.php for Gregorian date validation.

Careful - date_parse is perfectly happy with something like this:
 date_parse("2006-2-31");

A warning to some 

Caution: date_parse expects months 1..12 only.
date_parse("13/1/5769") for month=13, Ehul in Jewish calendar, results in month==3 instead of month==13.
It does, however, report the error array showing "Unexpected Character."
It would be nice if date_parse could handle the months properly (just report back a "13" for the month). The older approach of substr() is my workaround.

Output:
1. If the year-month-day is smaller than today (2009-11-23), but bigger than 1999: year => 2009
ID: 091122671325
Array ( [year] => 2009 [month] => 11 [day] => 22 )
2. If the year-month-day is the same as, or bigger than today, but smaller than 2000: year => 1909
ID: 091123671325
Array ( [year] => 1909 [month] => 11 [day] => 23 )

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com