WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

iso8601_to_datetime()

iso8601_to_datetime( string $date_string, string $timezone = ‘user’ ): string|false

In this article

Back to top

Given an ISO 8601 (Ymd\TH:i:sO) date, returns a MySQL DateTime (Y-m-d H:i:s) format used by post_date[_gmt].

Parameters

$date_stringstringrequired
Date and time in ISO 8601 format https://en.wikipedia.org/wiki/ISO_8601.
$timezonestringoptional
If set to 'gmt' returns the result in UTC. Default 'user'.

Default:'user'

Return

string|false The date and time in MySQL DateTime format – Y-m-d H:i:s, or false on failure.

Source

function iso8601_to_datetime( $date_string, $timezone = 'user' ) {
	$timezone    = strtolower( $timezone );
	$wp_timezone = wp_timezone();
	$datetime    = date_create( $date_string, $wp_timezone ); // Timezone is ignored if input has one.

	if ( false === $datetime ) {
		return false;
	}

	if ( 'gmt' === $timezone ) {
		return $datetime->setTimezone( new DateTimeZone( 'UTC' ) )->format( 'Y-m-d H:i:s' );
	}

	if ( 'user' === $timezone ) {
		return $datetime->setTimezone( $wp_timezone )->format( 'Y-m-d H:i:s' );
	}

	return false;
}

View all references View on Trac View on GitHub

UsesDescription
wp_timezone()wp-includes/functions.php

Retrieves the timezone of the site as a DateTimeZone object.

Used byDescription
wp_xmlrpc_server::mw_editPost()wp-includes/class-wp-xmlrpc-server.php

Edits a post.

wp_xmlrpc_server::mw_newPost()wp-includes/class-wp-xmlrpc-server.php

Creates a new post.

wp_xmlrpc_server::wp_editComment()wp-includes/class-wp-xmlrpc-server.php

Edits a comment.

wp_xmlrpc_server::_insert_post()wp-includes/class-wp-xmlrpc-server.php

Helper method for wp_newPost() and wp_editPost(), containing shared logic.

Changelog

VersionDescription
1.5.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.