strptime
strptime returns an array with the timestamp parsed, or false on error.
Month and weekday names and other language dependent strings respect the current locale set with setlocale (LC_TIME).
Parameters
- timestamp (string)
-
The string to parse (e.g. returned from strftime).
- format (string)
-
The format used in timestamp (e.g. the same as used in strftime). Note that some of the format options available to strftime may not have any effect within strptime; the exact subset that are supported will vary based on the operating system and C library in use.
For more information about the format options, read the strftime page.
Return Values
Returns an array or false on failure.
parameters | Description |
"tm_sec" | Seconds after the minute (0-61) |
"tm_min" | Minutes after the hour (0-59) |
"tm_hour" | Hour since midnight (0-23) |
"tm_mday" | Day of the month (1-31) |
"tm_mon" | Months since January (0-11) |
"tm_year" | Years since 1900 |
"tm_wday" | Days since Sunday (0-6) |
"tm_yday" | Days since January 1 (0-365) |
"unparsed" | the timestamp part which was not recognized using the specified format |
Notes
Note:
This function is not implemented on Windows platforms.
Note:
Internally, this function calls the strptime() function provided by the system's C library. This function can exhibit noticeably different behaviour across different operating systems. The use of date_parse_from_format, which does not suffer from these issues, is recommended.
Note:
"tm_sec" includes any leap seconds (currently upto 2 a year). For more information on leap seconds, see the Wikipedia article on leap seconds.
Changelog
Version | Description |
8.1.0 | This function has been deprecated. Use date_parse_from_format instead (for locale-independent parsing), or IntlDateFormatter::parse (for locale-dependent parsing) |