get_the_modified_time() WP 2.0.0

Retrieve the time at which the post was last modified. Works similar to get_the_modified_date().

Often this function is used within The Loop.

If you specify the $d parameter (display format), then this function will work exactly like the get_the_modified_date().

Return

false/String. Formatted date string or Unix timestamp. False on failure.

Usage

get_the_modified_time( $d, $post );

$d(string)

Format to use for retrieving the time the post was modified. Either 'G', 'U', or php date format defaults to the value specified in the time_format option. The comprehensive list of formats.
Default: ''

$post(int/WP_Post)

Post ID or WP_Post object, the publication time of which you want to get.
Default: current post

Examples

#1 Get the last modified date for the post

echo 'The post was modified: '. get_the_modified_time(); //> 01:39

#2 Get the last modified date for the post with the custom format

echo 'The post was modified: '. get_the_modified_date('H:i:s'); //> 01:39:56

#3 Add HTML tags to the date

To add HTML tags to the date, you should escape every character of the tag with backslash \ to avoid its interpretation as a date format character:

echo 'Modified: '. get_the_modified_date('j\<\s\u\p\>M\<\/\s\u\p\> Y');

// Modified: 25<sup>Dec</sup> 2011

Changelog

Code of get the modified time: wp-includes/general-template.php ^{WP 5.2.4}

<?php
function get_the_modified_time( $d = '', $post = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		// For backward compatibility, failures go through the filter below.
		$the_time = false;
	} elseif ( empty( $d ) ) {
		$the_time = get_post_modified_time( get_option( 'time_format' ), false, $post, true );
	} else {
		$the_time = get_post_modified_time( $d, false, $post, true );
	}

	/**
	 * Filters the localized time a post was last modified.
	 *
	 * @since 2.0.0
	 * @since 4.6.0 Added the `$post` parameter.
	 *
	 * @param string|bool  $the_time The formatted time or false if no post is found.
	 * @param string       $d        Format to use for retrieving the time the post was
	 *                               written. Accepts 'G', 'U', or php date format. Defaults
	 *                               to value specified in 'time_format' option.
	 * @param WP_Post|null $post     WP_Post object or null if no post is found.
	 */
	return apply_filters( 'get_the_modified_time', $the_time, $d, $post );
}

Related Functions

From tag: modified (author date time)

More from tag: date time

More from category: Posts, pages...