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

String|Int|false. 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() get the modified time ^{WP 5.7.2}

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

	if ( ! $post ) {
		// For backward compatibility, failures go through the filter below.
		$the_time = false;
	} else {
		$_format = ! empty( $format ) ? $format : get_option( 'time_format' );

		$the_time = get_post_modified_time( $_format, 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|int|false $the_time The formatted time or false if no post is found.
	 * @param string           $format   Format to use for retrieving the time the post
	 *                                   was modified. Accepts 'G', 'U', or PHP date format.
	 * @param WP_Post|null     $post     WP_Post object or null if no post is found.
	 */
	return apply_filters( 'get_the_modified_time', $the_time, $format, $post );
}

Related Functions

From tag: modified (author date time)

More from tag: date time

More from category: Posts, pages...