get_the_modified_date() │ WP 2.1.0

Gets the date (time) when the post was last modified.

This function is usually used inside the loop.

Use get_the_modified_time( $d, $post ) to get the modification time of the post.

Uses: get_post_modified_time()
Used By: the_modified_date()
Hooks from the function

Returns

String|Int|false. The modification date.

Usage

get_the_modified_date( $d, $post );
$d(string)
The format in which the date will be displayed. Specify in the format accepted in PHP: see here.
Default: get_option('date_format')
$post(int/WP_Post)
ID or post object for which to get the modification date. Since Version 4.6.
Default: null (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.

get_the_modified_date() code WP 7.0

wp-includes/general-template.php 
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 );
}

modified (author date time)

date time

Posts, pages...