On this page
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
$timezonestring Optional-
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 thepost_datefield, which proxies to the timezone set for the site.
'gmt'uses thepost_date_gmtfield.
Default'server'.Default:
'server' $post_typestring Optional-
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
File: wp-includes/post.php. View all references
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.
Related
Uses
| 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. |
Used By
| 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
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_lastpostmodified