iso8601_to_datetime( string $date_string, string $timezone = 'user' )

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 Parameters

$date_string

(string) (Required) Date and time in ISO 8601 format https://en.wikipedia.org/wiki/ISO_8601.

$timezone

(string) (Optional) If set to 'gmt' returns the result in UTC.

Default value: 'user'


Top ↑

Return Return

(string|bool) The date and time in MySQL DateTime format

  • Y-m-d H:i:s, or false on failure.


Top ↑

Source Source

File: wp-includes/formatting.php

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;
}


Top ↑

Changelog Changelog

Changelog
Version Description
1.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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