get_lastpostmodified() – Function | Developer.WordPress.org

Gets the most recent time that a post on the site was modified.

Description

The server timezone is the default and is the difference between GMT and server time. The ‘blog’ value is just when the last post was modified.
The ‘gmt’ is when the last post was modified in GMT time.

Parameters

$timezonestringoptional: The timezone for the timestamp. See get_lastpostdate() for information on accepted values.
Default 'server'.
More Arguments from get_lastpostdate( … $timezone )
The timezone for the timestamp. Accepts 'server', 'blog', or 'gmt'.
'server' uses the server’s internal timezone.
'blog' uses the post_date field, which proxies to the timezone set for the site.
'gmt' uses the post_date_gmt field.
Default 'server'.
Default:'server'
$post_typestringoptional: The post type to check. Default 'any'.
Default:'any'

Return

string The timestamp in ‘Y-m-d H:i:s’ format, or false on failure.

Source

function get_lastpostmodified( $timezone = 'server', $post_type = 'any' ) {
	/**
	 * Pre-filter the return value of get_lastpostmodified() before the query is run.
	 *
	 * @since 4.4.0
	 *
	 * @param string|false $lastpostmodified The most recent time that a post was modified,
	 *                                       in 'Y-m-d H:i:s' format, or false. Returning anything
	 *                                       other than false will short-circuit the function.
	 * @param string       $timezone         Location to use for getting the post modified date.
	 *                                       See get_lastpostdate() for accepted `$timezone` values.
	 * @param string       $post_type        The post type to check.
	 */
	$lastpostmodified = apply_filters( 'pre_get_lastpostmodified', false, $timezone, $post_type );

	if ( false !== $lastpostmodified ) {
		return $lastpostmodified;
	}

	$lastpostmodified = _get_last_post_time( $timezone, 'modified', $post_type );
	$lastpostdate     = get_lastpostdate( $timezone, $post_type );

	if ( $lastpostdate > $lastpostmodified ) {
		$lastpostmodified = $lastpostdate;
	}

	/**
	 * Filters the most recent time that a post on the site was modified.
	 *
	 * @since 2.3.0
	 * @since 5.5.0 Added the `$post_type` parameter.
	 *
	 * @param string|false $lastpostmodified The most recent time that a post was modified,
	 *                                       in 'Y-m-d H:i:s' format. False on failure.
	 * @param string       $timezone         Location to use for getting the post modified date.
	 *                                       See get_lastpostdate() for accepted `$timezone` values.
	 * @param string       $post_type        The post type to check.
	 */
	return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone, $post_type );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘get_lastpostmodified’, string|false $lastpostmodified, string $timezone, string $post_type ): Filters the most recent time that a post on the site was modified.
apply_filters( ‘pre_get_lastpostmodified’, string|false $lastpostmodified, string $timezone, string $post_type ): Pre-filter the return value of get_lastpostmodified() before the query is run.

Uses	Description
get_lastpostdate()`wp-includes/post.php`	Retrieves the most recent time that a post on the site was published.
_get_last_post_time()`wp-includes/post.php`	Gets the timestamp of the last time any post was modified or published.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Used by	Description
get_feed_build_date()`wp-includes/feed.php`	Gets the UTC time of the most recently modified post from WP_Query.
WP::send_headers()`wp-includes/class-wp.php`	Sends additional HTTP headers for caching, content type, etc.

Changelog

Version	Description
4.4.0	The `$post_type` argument was added.
1.2.0	Introduced.

User Contributed Notes

Skip to note 2 content

Lucas 1 year 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
Code for showing the date and time formatted as you need:
```
$blog_modify_date = get_lastpostmodified( 'blog' );
$not_formatted_date = strtotime( $blog_modify_date );
$formatted_date = date( 'd/m/Y H:i', $not_formatted_date ); 
echo $formatted_date;
```
Log in to add feedback

get_lastpostmodified( string $timezone = ‘server’, string $post_type = ‘any’ ): string

In this article