PHP | date_parse_from_format() Function

The date_parse_from_format() is an inbuilt function in PHP which is used to get information about given date formatted according to the specified format. The date_parse_from_format() function accepts two parameters and returns associative array with detailed information about given date.

Syntax:

array date_parse_from_format ( $format, $date )

Parameters: This function accepts two parameters as mentioned above and described below:

• $format: It is a required parameters which is used to specify the date format. The following parameters string are used in format.
  1. Day:
     • d and j: It represents the day of the month, 2 digits with or without leading zeros.
     • D and l: A textual representation of a day.
     • S: English ordinal suffix for the day of the month, 2 characters. It’s ignored while processing.
     • z: The day of the year (starting from 0)
  2. Month:
     • F and M: A textual representation of a month, such as January or Sept
     • m and n: Numeric representation of a month, with or without leading zeros
  3. Year:
     • Y: A full numeric representation of a year, 4 digits
     • y: A two digit representation of a year (which is assumed to be in the range 1970-2069, inclusive)
  4. Time:
     • a and A: Ante meridiem and Post meridiem
     • g and h: 12-hour format of an hour with or without leading zero
     • G and H: 24-hour format of an hour with or without leading zeros
     • i: Minutes with leading zeros
     • s: Seconds, with leading zeros
     • u: Microseconds (up to six digits)
  5. Timezone:
     • e, O, P and T: Timezone identifier, or difference to UTC in hours, or difference to UTC with colon between hours and minutes, or timezone abbreviation
  6. Full Date/Time:
     • U: Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT)
  7. Whitespace and Separators:
     • (space): One space or one tab
     • #: One of the following separation symbol: ;, :, /, .,,, -, ( or )
     • ;, :, /, .,,, -, ( or ): The specified character.
     • ?: A random byte
     • *: Random bytes until the next separator or digit
     • !: Resets all fields (year, month, day, hour, minute, second, fraction and timezone information) to the Unix Epoch
     • |: Resets all fields (year, month, day, hour, minute, second, fraction and timezone information) to the Unix Epoch if they have not been parsed yet
     • +: If this format specifier is present, trailing data in the string will not cause an error, but a warning instead
• $date: This is the mandatory parameter which is used to representing the date.

Return Value: This function returns an array containing the detail description about date.

Below programs illustrate the date_parse_from_format() function in PHP.

<?php

// Declare and initialize date variable.
$date = "0.9.2018 5:00+01:00";

// Function is used to return the detail about date.
print_r(date_parse_from_format("j.n.Y H:iP", $date));
?>

Output:

Array
(
    [year] => 2018
    [month] => 9
    [day] => 0
    [hour] => 5
    [minute] => 0
    [second] => 0
    [fraction] => 
    [warning_count] => 1
    [warnings] => Array
        (
            [19] => The parsed date was invalid
        )

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

    [is_localtime] => 1
    [zone_type] => 1
    [zone] => -60
    [is_dst] => 
)

Program 2:

<?php

// Declare and initialize date variable.
$date = "2015.0.9";

// Function is used to return the detail about date.
print_r(date_parse_from_format("Y.z.n", $date));
?>

Output:

Array
(
    [year] => 2015
    [month] => 9
    [day] => 1
    [hour] => 
    [minute] => 
    [second] => 
    [fraction] => 
    [warning_count] => 0
    [warnings] => Array
        (
        )

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

    [is_localtime] => 
)

Reference: http://php.net/manual/en/function.date-parse-from-format.php