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

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 );
}

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.

Changelog

VersionDescription
4.4.0The $post_type argument was added.
1.2.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.