mysql2date( string $format, string $date, bool $translate = true )

Convert given MySQL date string into a different format.

Contents

Description Description

$format should be a PHP date format string. ‘U’ and ‘G’ formats will return a sum of timestamp with timezone offset. $date is expected to be local time in MySQL format (Y-m-d H:i:s).

Historically UTC time could be passed to the function to produce Unix timestamp.

If $translate is true then the given date and format string will be passed to wp_date() for translation.

Parameters Parameters

$format

(string) (Required) Format of the date to return.

$date

(string) (Required) Date string to convert.

$translate

(bool) (Optional) Whether the return date should be translated.

Default value: true

Top ↑

Return Return

(string|int|false) Formatted date string or sum of Unix timestamp and timezone offset. False on failure.

Top ↑

Source Source

File: wp-includes/functions.php 

function mysql2date( $format, $date, $translate = true ) {
	if ( empty( $date ) ) {
		return false;
	}

	$datetime = date_create( $date, wp_timezone() );

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

	// Returns a sum of timestamp with timezone offset. Ideally should never be used.
	if ( 'G' === $format || 'U' === $format ) {
		return $datetime->getTimestamp() + $datetime->getOffset();
	}

	if ( $translate ) {
		return wp_date( $format, $datetime->getTimestamp() );
	}

	return $datetime->format( $format );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
0.71 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/functions.php: wp_timezone()

Retrieves the timezone from site settings as a DateTimeZone object.
wp-includes/functions.php: wp_date()

Retrieves the date, in localized format.

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/feed.php: get_feed_build_date()

Get the timestamp of the most recently modified post from WP_Query.
wp-includes/class-wp-query.php: WP_Query::generate_postdata()

Generate post data.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::save_changeset_post()

Save the post for the loaded changeset.
wp-includes/comment.php: wp_check_comment_flood()

Checks whether comment flooding is occurring.
wp-includes/functions.php: mysql_to_rfc3339()

Parses and formats a MySQL datetime (Y-m-d H:i:s) for ISO8601 (Y-m-d\TH:i:s).
wp-admin/includes/class-wp-ms-sites-list-table.php: WP_MS_Sites_List_Table::column_lastupdated()

Handles the lastupdated column output.
wp-admin/includes/class-wp-ms-sites-list-table.php: WP_MS_Sites_List_Table::column_registered()

Handles the registered column output.
wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::column_registered()

Handles the registered date column output.
wp-admin/includes/export.php: export_wp()

Generates the WXR export file for download.
wp-admin/includes/template.php: get_inline_data()

Adds hidden fields with the data for use in the inline editor for posts and pages.
wp-admin/includes/template.php: touch_time()

Print out HTML form date elements for editing post or comment publish date.
wp-admin/includes/media.php: get_media_item()

Retrieve HTML form for modifying the image attachment.
wp-admin/includes/ajax-actions.php: wp_ajax_wp_fullscreen_save_post()

Ajax handler for saving posts from the fullscreen editor.
wp-admin/includes/ajax-actions.php: wp_ajax_find_posts()

Ajax handler for querying posts for the Find Posts modal.
wp-includes/general-template.php: wp_get_archives()

Display archive links based on type and format.
wp-includes/general-template.php: the_date_xml()

Outputs the date in iso8601 format for xml files.
wp-includes/deprecated.php: get_boundary_post_rel_link()

Get boundary post relational link.
wp-includes/deprecated.php: get_parent_post_rel_link()

Get parent post relational link.
wp-includes/class-wp.php: WP::send_headers()

Sends additional HTTP headers for caching, content type, etc.
wp-includes/link-template.php: get_adjacent_post_link()

Retrieves the adjacent post link.
wp-includes/link-template.php: get_adjacent_post_rel_link()

Retrieves the adjacent post relational link.
wp-includes/class-walker-page.php: Walker_Page::start_el()

Outputs the beginning of the current element in the tree.
wp-includes/media.php: wp_prepare_attachment_for_js()

Prepares an attachment post object for JS, where it is expected to be JSON-encoded and fit into an Attachment model.
wp-includes/ms-functions.php: wpmu_validate_user_signup()

Sanitize and validate data required for a user sign-up.
wp-includes/ms-functions.php: wpmu_validate_blog_signup()

Processes new site registrations.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_editPost()

Edit a post for any registered post type.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_convert_date()

Convert a WordPress date string to an IXR_Date object.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_convert_date_gmt()

Convert a WordPress GMT date string to an IXR_Date object.
wp-includes/comment-template.php: get_comment_time()

Retrieve the comment time of the current comment.
wp-includes/comment-template.php: get_comment_date()

Retrieve the comment date of the current comment.
wp-includes/class-wp-editor.php: _WP_Editors::wp_link_query()

Performs post queries for internal linking.
Show 26 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

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