get_the_modified_date()WP 2.1.0

Retrieve the date on which the post was last modified.

Hooks from the function

Return

String|Int|false. Date the current post was modified. False on failure.

Usage

get_the_modified_date( $format, $post );
$format(string)
PHP date format. option.
Default: 'date_format'
$post(int|WP_Post)
Post ID or WP_Post object.
Default: current post

Examples

0

#1 Display the date the post was last modified:

echo 'The post was modified: '. get_the_modified_date();
0

#2 Specify a custom format for the date of the last change:

echo 'The post was changed: .' get_the_modified_date('F j, Y');
// Post modified: August 31, 2013

echo 'Modified: '. get_the_modified_date('F j, Y in G:i');
// Modified: January 23, 2013 at 14:38
0

#3 To insert html tags into the format, you must escape them with \:

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

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

Changelog

Since 2.1.0 Introduced.
Since 4.6.0 Added the $post parameter.

Code of get_the_modified_date() WP 6.0.1

function get_the_modified_date( $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( 'date_format' );

		$the_time = get_post_modified_time( $_format, false, $post, true );
	}

	/**
	 * Filters the date a post was last modified.
	 *
	 * @since 2.1.0
	 * @since 4.6.0 Added the `$post` parameter.
	 *
	 * @param string|int|false $the_time The formatted date or false if no post is found.
	 * @param string           $format   PHP date format.
	 * @param WP_Post|null     $post     WP_Post object or null if no post is found.
	 */
	return apply_filters( 'get_the_modified_date', $the_time, $format, $post );
}