current_time( string $type, int|bool $gmt )

Retrieve the current time based on specified type.

Contents

Description Description

The ‘mysql’ type will return the time in the format for MySQL DATETIME field. The ‘timestamp’ type will return the current timestamp. Other strings will be interpreted as PHP date formats (e.g. ‘Y-m-d’).

If $gmt is set to either ‘1’ or ‘true’, then both types will use GMT time. if $gmt is false, the output is adjusted with the GMT offset in the WordPress option.

Parameters Parameters

$type

(string) (Required) Type of time to retrieve. Accepts 'mysql', 'timestamp', or PHP date format string (e.g. 'Y-m-d').

$gmt

(int|bool) (Optional) Whether to use GMT timezone. Default false.

Top ↑

Return Return

(int|string) Integer if $type is 'timestamp', string otherwise.

Top ↑

Source Source

File: wp-includes/functions.php 

function current_time( $type, $gmt = 0 ) {
	switch ( $type ) {
		case 'mysql':
			return ( $gmt ) ? gmdate( 'Y-m-d H:i:s' ) : gmdate( 'Y-m-d H:i:s', ( time() + ( get_option( 'gmt_offset' ) * HOUR_IN_SECONDS ) ) );
		case 'timestamp':
			return ( $gmt ) ? time() : time() + ( get_option( 'gmt_offset' ) * HOUR_IN_SECONDS );
		default:
			return ( $gmt ) ? gmdate( $type ) : gmdate( $type, time() + ( get_option( 'gmt_offset' ) * HOUR_IN_SECONDS ) );
	}
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
1.0.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/option.php: get_option()

Retrieves an option value based on an option name.

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/ms-site.php: wp_insert_site()

Inserts a new site into the database.
wp-includes/ms-site.php: wp_update_site()

Updates a site in the database.
wp-includes/user.php: wp_create_user_request()

Create and log a user request to perform a specific action.
wp-admin/includes/file.php: wp_privacy_generate_personal_data_export_file()

Generate the personal data export file.
wp-admin/includes/user.php: WP_Privacy_Requests_Table::get_timestamp_as_date()

Convert timestamp for display.
wp-admin/includes/class-wp-community-events.php: WP_Community_Events::trim_events()

Prepares the event list for presentation.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::save_changeset_post()

Save the post for the loaded changeset.
wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php: WP_REST_Comments_Controller::create_item()

Creates a comment.
wp-includes/functions.php: _wp_upload_dir()

A non-filtered, non-cached version of wp_upload_dir() that doesn’t check the path.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::customize_pane_settings()

Print JavaScript settings for parent window.
wp-admin/includes/schema.php: populate_network()

Populate network settings.
wp-admin/includes/dashboard.php: wp_dashboard_recent_posts()

Generates Publishing Soon and Recently Published sections.
wp-admin/includes/upgrade.php: wp_install_defaults()

Creates the initial content for a newly-installed site.
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: media_handle_upload()

Save a file submitted from a POST request and create an attachment post for it.
wp-admin/includes/media.php: media_handle_sideload()

Handles a side-loaded file in the same way as an uploaded file is handled by media_handle_upload().
wp-admin/includes/ajax-actions.php: wp_ajax_add_meta()

Ajax handler for adding meta.
wp-admin/includes/meta-boxes.php: post_submit_meta_box()

Displays post submit form fields.
wp-includes/general-template.php: get_calendar()

Display calendar with days that have posts as links.
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieves an array of posts based on query variables.
wp-includes/functions.php: date_i18n()

Retrieve the date in localized format, based on a sum of Unix timestamp and timezone offset in seconds.
wp-includes/link-template.php: get_month_link()

Retrieves the permalink for the month archives with year.
wp-includes/link-template.php: get_day_link()

Retrieves the permalink for the day archives with year and month.
wp-includes/link-template.php: get_year_link()

Retrieves the permalink for the year archives.
wp-includes/date.php: WP_Date_Query::build_mysql_datetime()

Builds a MySQL format date/time based on some query parameters.
wp-includes/post-template.php: wp_post_revision_title_expanded()

Retrieve formatted date timestamp of a revision (linked to that revisions’s page).
wp-includes/post.php: wp_insert_post()

Insert or update a post.
wp-includes/post.php: wp_update_post()

Update a post with new post data.
wp-includes/ms-functions.php: wpmu_log_new_registrations()

Logs the user email, IP, and registration date of a new site.
wp-includes/ms-functions.php: wpmu_activate_signup()

Activate a signup.
wp-includes/ms-functions.php: wpmu_signup_blog()

Record site signup information for future activation.
wp-includes/ms-functions.php: wpmu_signup_user()

Record user signup information for future activation.
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/ms-blogs.php: wpmu_update_blogs_date()

Update the last_updated field for the current site.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::blogger_newPost()

Creates new post.
wp-includes/comment.php: wp_new_comment()

Adds a new comment to the database.
wp-includes/comment.php: wp_insert_comment()

Inserts a comment into the database.
Show 33 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Examine the results

    <?php

echo "current_time( 'mysql' ) returns local site time: " . current_time( 'mysql' ) . '<br />';
echo "current_time( 'mysql', 1 ) returns GMT: " . current_time( 'mysql', 1 ) . '<br />';
echo "current_time( 'timestamp' ) returns local site time: " . date( 'Y-m-d H:i:s', current_time( 'timestamp', 0 ) );
echo "current_time( 'timestamp', 1 ) returns GMT: " . date( 'Y-m-d H:i:s', current_time( 'timestamp', 1 ) );

?>
  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by kapils003 —

    The code snippet gives an Warning with “split” function because
    the function was DEPRECATED in PHP 5.3.0, and REMOVED in PHP 7.0.0.

    Alternatives to this function include:

    preg_split()

    On using preg_split(), we get the required output. Code snippet below:

    $blogtime = current_time( 'mysql' );
    list( $today_year, $today_month, $today_day, $hour, $minute, $second ) = preg_split( "([^0-9])", $blogtime );
    echo $hour;

    For reference:
    http://php.net/manual/en/function.split.php

  4. Skip to note 4 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Andrei Surdu —

    When working with time functions, you must use current_time('timestamp') NOT time().

    current_time('timestamp') return blog specific timestamp that is set under Settings->General.
    time() return the time based on date.timezone setting from php.ini.

    Conclusion:
    time() !== current_time('timestamp') // There is a big chance that they are not equal

    Always use: current_time(‘timestamp’)

  5. Skip to note 5 content
    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    This example gets the current time and assigns the parameters to variables.

    <?php 
$blogtime = current_time( 'mysql' ); 
list( $today_year, $today_month, $today_day, $hour, $minute, $second ) = split( '([^0-9])', $blogtime );
?>

    Example of format of current_time( 'mysql' ):

    2005-08-05 10:41:13

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