get_lastpostmodified

The timeline below displays how wordpress function get_lastpostmodified has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Gets the most recent time that a post on the site was modified.
 *
 * 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.
 *
 * @since 1.2.0
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. See get_lastpostdate()
 *                          for information on accepted values.
 *                          Default 'server'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The timestamp in 'Y-m-d H:i:s' format, or false on failure.
 */
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);
}

WordPress Version: 5.5

/**
 * Get the most recent time that a post on the site was modified.
 *
 * 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.
 *
 * @since 1.2.0
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. See get_lastpostdate()
 *                          for information on accepted values.
 *                          Default 'server'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The timestamp in 'Y-m-d H:i:s' format, or false on failure.
 */
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);
}

WordPress Version: .10

/**
 * Get the most recent time that a post on the site was modified.
 *
 * 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.
 *
 * @since 1.2.0
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. See get_lastpostdate()
 *                          for information on accepted values.
 *                          Default 'server'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The timestamp in 'Y-m-d H:i:s' format, or false on failure.
 */
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);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filters the most recent time that a post was modified.
     *
     * @since 2.3.0
     *
     * @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.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 5.3

/**
 * Get the most recent time that a post on the site was modified.
 *
 * 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.
 *
 * @since 1.2.0
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. See get_lastpostdate()
 *                          for information on accepted values.
 *                          Default 'server'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The timestamp in 'Y-m-d H:i:s' format.
 */
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);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filters the most recent time that a post was modified.
     *
     * @since 2.3.0
     *
     * @param string $lastpostmodified The most recent time that a post was modified, in 'Y-m-d H:i:s' format.
     * @param string $timezone         Location to use for getting the post modified date.
     *                                 See get_lastpostdate() for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 4.6

/**
 * Get the timestamp of the last time any post was modified.
 *
 * 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.
 *
 * @since 1.2.0
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. See get_lastpostdate()
 *                          for information on accepted values.
 *                          Default 'server'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The timestamp.
 */
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 $lastpostmodified Date the last post was modified.
     *                                 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);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filters the date the last post was modified.
     *
     * @since 2.3.0
     *
     * @param string $lastpostmodified Date the last post was modified.
     * @param string $timezone         Location to use for getting the post modified date.
     *                                 See get_lastpostdate() for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 4.4

/**
 * Get the timestamp of the last time any post was modified.
 *
 * 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.
 *
 * @since 1.2.0
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. See {@see get_lastpostdate()}
 *                          for information on accepted values.
 *                          Default 'server'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The timestamp.
 */
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 $lastpostmodified Date the last post was modified.
     *                                 Returning anything other than false will short-circuit the function.
     * @param string $timezone         Location to use for getting the post modified date.
     *                                 See {@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);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filter the date the last post was modified.
     *
     * @since 2.3.0
     *
     * @param string $lastpostmodified Date the last post was modified.
     * @param string $timezone         Location to use for getting the post modified date.
     *                                 See {@see get_lastpostdate()} for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 4.1

/**
 * Get the timestamp of the last time any post was modified.
 *
 * 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.
 *
 * @since 1.2.0
 *
 * @param string $timezone Optional. The timezone for the timestamp. Uses the server's internal timezone.
 *                         Accepts 'server', 'blog', 'gmt'. or 'server'. 'server' uses the server's
 *                         internal timezone. 'blog' uses the `post_modified` field, which proxies
 *                         to the timezone set for the site. 'gmt' uses the `post_modified_gmt` field.
 *                         Default 'server'.
 * @return string The timestamp.
 */
function get_lastpostmodified($timezone = 'server')
{
    $lastpostmodified = _get_last_post_time($timezone, 'modified');
    $lastpostdate = get_lastpostdate($timezone);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filter the date the last post was modified.
     *
     * @since 2.3.0
     *
     * @param string $lastpostmodified Date the last post was modified.
     * @param string $timezone         Location to use for getting the post modified date.
     *                                 See {@see get_lastpostmodified()} for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 4.0

/**
 * Retrieve last post modified date depending on timezone.
 *
 * 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.
 *
 * @since 1.2.0
 *
 * @param string $timezone The location to get the time. Accepts 'gmt', 'blog', or 'server'.
 *                         Default 'server'.
 * @return string The date the post was last modified.
 */
function get_lastpostmodified($timezone = 'server')
{
    $lastpostmodified = _get_last_post_time($timezone, 'modified');
    $lastpostdate = get_lastpostdate($timezone);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filter the date the last post was modified.
     *
     * @since 2.3.0
     *
     * @param string $lastpostmodified Date the last post was modified.
     * @param string $timezone         Location to use for getting the post modified date.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 3.9

/**
 * Retrieve last post modified date depending on timezone.
 *
 * 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.
 *
 * @since 1.2.0
 *
 * @param string $timezone The location to get the time. Can be 'gmt', 'blog', or 'server'.
 * @return string The date the post was last modified.
 */
function get_lastpostmodified($timezone = 'server')
{
    $lastpostmodified = _get_last_post_time($timezone, 'modified');
    $lastpostdate = get_lastpostdate($timezone);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    /**
     * Filter the date the last post was modified.
     *
     * @since 2.3.0
     *
     * @param string $lastpostmodified Date the last post was modified.
     * @param string $timezone         Location to use for getting the post modified date.
     */
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}

WordPress Version: 3.7

/**
 * Retrieve last post modified date depending on timezone.
 *
 * 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.
 *
 * @since 1.2.0
 * @uses apply_filters() Calls 'get_lastpostmodified' filter
 *
 * @param string $timezone The location to get the time. Can be 'gmt', 'blog', or 'server'.
 * @return string The date the post was last modified.
 */
function get_lastpostmodified($timezone = 'server')
{
    $lastpostmodified = _get_last_post_time($timezone, 'modified');
    $lastpostdate = get_lastpostdate($timezone);
    if ($lastpostdate > $lastpostmodified) {
        $lastpostmodified = $lastpostdate;
    }
    return apply_filters('get_lastpostmodified', $lastpostmodified, $timezone);
}