Docs: Correct description for mysql_to_rfc3339().

Despite historical function name, the output does not conform to RFC3339 format, which must contain timezone.

Props Rarst.
See #42542.

git-svn-id: https://develop.svn.wordpress.org/trunk@43383 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov 2018-06-26 17:52:58 +00:00
parent 0a9c044283
commit 63aab770eb

View File

@ -5849,15 +5849,18 @@ function wp_post_preview_js() {
} }
/** /**
* Parses and formats a MySQL datetime (Y-m-d H:i:s) for ISO8601/RFC3339. * Parses and formats a MySQL datetime (Y-m-d H:i:s) for ISO8601 (Y-m-d\TH:i:s).
* *
* Explicitly strips timezones, as datetimes are not saved with any timezone * Explicitly strips timezones, as datetimes are not saved with any timezone
* information. Including any information on the offset could be misleading. * information. Including any information on the offset could be misleading.
* *
* Despite historical function name, the output does not conform to RFC3339 format,
* which must contain timezone.
*
* @since 4.4.0 * @since 4.4.0
* *
* @param string $date_string Date string to parse and format. * @param string $date_string Date string to parse and format.
* @return string Date formatted for ISO8601/RFC3339. * @return string Date formatted for ISO8601 without time zone.
*/ */
function mysql_to_rfc3339( $date_string ) { function mysql_to_rfc3339( $date_string ) {
$formatted = mysql2date( 'c', $date_string, false ); $formatted = mysql2date( 'c', $date_string, false );