Changeset 34846

Timestamp:

10/06/2015 03:18:45 AM (9 years ago)

Author:

wonderboymusic

Message:

REST API: add a utility function, mysql_to_rfc3339() to functions.php

Background:
​https://github.com/WP-API/WP-API/commit/6d0ad766ca525c7a3aee921b66554ddf21a5c023

Props rmmcue.
See #33982.

File:

• trunk/src/wp-includes/functions.php (modified) (2 diffs)

trunk/src/wp-includes/functions.php

@@ -681 +681 @@
  *
  * Using an associative array:
- * 
+ *
  *     add_query_arg( array(
  *         'key1' => 'value1',
  *         'key2' => 'value2',
  *     ), 'http://example.com' );
- * 
+ *
  * Omitting the URL from either use results in the current URL being used
  * (the value of `$_SERVER['REQUEST_URI']`).
- * 
+ *
  * Values are expected to be encoded appropriately with urlencode() or rawurlencode().
  *
@@ -5023 +5023 @@
     <?php
 }
+
+/**
+ * Parses and formats a MySQL datetime (Y-m-d H:i:s) for ISO8601/RFC3339.
+ *
+ * Explicitly strips timezones, as datetimes are not saved with any timezone
+ * information. Including any information on the offset could be misleading.
+ *
+ * @since 4.4.0
+ *
+ * @param string $date_string Date string to parse and format.
+ * @return string Date formatted for ISO8601/RFC3339.
+ */
+function mysql_to_rfc3339( $date_string ) {
+    $formatted = mysql2date( 'c', $date_string, false );
+
+    // Strip timezone information
+    return preg_replace( '/(?:Z|[+-]\d{2}(?::\d{2})?)$/', '', $formatted );
+}