the_modified_date() – Function | Developer.WordPress.org

Displays the date on which the post was last modified.

Parameters

$formatstringoptional: PHP date format. Defaults to the 'date_format' option.
Default:''
$beforestringoptional: Output before the date.
Default:''
$afterstringoptional: Output after the date.
Default:''
$displaybooloptional: Whether to echo the date or return it.
Default:true

This tag works just like the_modified_time(), which also displays the time/date a post was last modified. This tag must be used within The Loop. If no format parameter is specified, the Default date format (please note that says Date format) setting from Administration > Settings > General is used for the display format.

If the post or page is not yet modified, the modified date is the same as the creation date.

Use get_the_modified_date() to retrieve the value.

Source

function the_modified_date( $format = '', $before = '', $after = '', $display = true ) {
	$the_modified_date = $before . get_the_modified_date( $format ) . $after;

	/**
	 * Filters the date a post was last modified, for display.
	 *
	 * @since 2.1.0
	 *
	 * @param string $the_modified_date The last modified date.
	 * @param string $format            PHP date format.
	 * @param string $before            HTML output before the date.
	 * @param string $after             HTML output after the date.
	 */
	$the_modified_date = apply_filters( 'the_modified_date', $the_modified_date, $format, $before, $after );

	if ( $display ) {
		echo $the_modified_date;
	} else {
		return $the_modified_date;
	}
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘the_modified_date’, string $the_modified_date, string $format, string $before, string $after ): Filters the date a post was last modified, for display.

Uses	Description
get_the_modified_date()`wp-includes/general-template.php`	Retrieves the date on which the post was last modified.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Changelog

Version	Description
2.1.0	Introduced.

User Contributed Notes

Skip to note 5 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Default Usage
Displays the date the post was last modified, using the Default date format setting (e.g. F j, Y) from Administration > Settings > General.
```
<p><?php printf( __( 'Last modified: %s', 'textdomain' ), get_the_modified_date() ); ?></p>
```
Last modified: December 2, 2006
Log in to add feedback
Skip to note 6 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Date as Month Day, Year
Displays the last modified date in the date format ‘F j, Y’ (ex: December 2, 2006).
```
<div><?php printf( __( 'Last modified: %s', 'textdomain' ), get_the_modified_date( 'F j, Y' ) ); ?></div>
```
Last modified: December 2, 2006
Log in to add feedback
Skip to note 7 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Date and Time
Displays the date and time.
```
<p><?php printf( __( 'Modified: %1$s at  %2$s', 'textdomain' ),
	get_the_modified_date( 'F j, Y' ) ),
	get_the_modified_date( 'g:i a' )
); ?></p>
```
Modified: December 2, 2006 at 10:36 pm
Log in to add feedback
Skip to note 8 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Date with superscript or subscript number suffixes
Displays the date with a superscript or subscript st, nd, rd or th after the day. Because characters from the alphabet are used to represent the date format types, each of the HTML tag characters need to be escaped using a back slash. Superscript HTML tag is <sup> and subscript is <sub>.
```
<p><?php printf( __( 'Modified: %s', 'textdomain' ), get_the_modified_date('j\<\s\u\p\>S\<\/\s\u\p\> M Y') ); ?></p>
```
Modified: 2nd Dec 2006
Log in to add feedback

the_modified_date( string $format = '', string $before = '', string $after = '', bool $display = true ): string|void

In this article

Parameters

Return

More Information

Source

Hooks

Changelog

User Contributed Notes