get_lastpostmodified() WordPress Function
The get_lastpostmodified() function is used to get the date and time of the last post that was modified. This function can be used to display the date and time of the last post that was modified on a WordPress site.
get_lastpostmodified( string $timezone = 'server', string $post_type = 'any' ) #
Get 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
- $timezone
(string)(Optional) The timezone for the timestamp. See get_lastpostdate() for information on accepted values.
Default value: 'server'
- $post_type
(string)(Optional) The post type to check.
Default value: 'any'
Return
(string) The timestamp in 'Y-m-d H:i:s' format, or false on failure.
Source
File: wp-includes/post.php
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 ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.4.0 | The $post_type argument was added. |
1.2.0 | Introduced. |