get_the_time( string $d = '', int|WP_Post $post = null )

Retrieve the time at which the post was written.


Description Description


Parameters Parameters

$d

(string) (Optional) Format to use for retrieving the time the post was written. Either 'G', 'U', or php date format defaults to the value specified in the time_format option.

Default value: ''

$post

(int|WP_Post) (Optional) WP_Post object or ID. Default is global $post object.

Default value: null


Top ↑

Return Return

(string|int|false) Formatted date string or Unix timestamp if $id is 'U' or 'G'. False on failure.


Top ↑

Source Source

File: wp-includes/general-template.php

function get_the_time( $d = '', $post = null ) {
	$post = get_post($post);

	if ( ! $post ) {
		return false;
	}

	if ( '' == $d )
		$the_time = get_post_time(get_option('time_format'), false, $post, true);
	else
		$the_time = get_post_time($d, false, $post, true);

	/**
	 * Filters the time a post was written.
	 *
	 * @since 1.5.0
	 *
	 * @param string      $the_time The formatted time.
	 * @param string      $d        Format to use for retrieving the time the post was written.
	 *                              Accepts 'G', 'U', or php date format value specified
	 *                              in 'time_format' option. Default empty.
	 * @param int|WP_Post $post     WP_Post object or ID.
	 */
	return apply_filters( 'get_the_time', $the_time, $d, $post );
}

Top ↑

Changelog Changelog

Changelog
Version Description
1.5.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note content
    Contributed by Codex

    Basic Example

    Returns the time of the current post using the WordPress default format, and displays it using the PHP echo command.

    <?php echo get_the_time(); ?>
    

    Returns the time of the post with ID $post->ID in the WordPress default format.

    <?php echo get_the_time( '', $post->ID ); ?>
    
  2. Skip to note content
    Contributed by Codex

    Getting Unix Timestamp

    Assigns the local time of the current post in seconds (since January 1 1970, known as the Unix Epoch) to the variable $u_time.

    <?php $local_timestamp = get_the_time( 'U' ); ?>
    

    In most cases, you would probably want the epoch time for GMT (rather than for the local time zone), which you can get with the get_post_time() function, setting the $gmt option to true:

    <?php $gmt_timestamp = get_post_time( 'U', true ); ?>
    

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