get_lastpostdate

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

WordPress Version: 5.5

/**
 * Retrieves the most recent time that a post on the site was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted.
 * The 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. 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'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The date of the last post, or false on failure.
 */
function get_lastpostdate($timezone = 'server', $post_type = 'any')
{
    $lastpostdate = _get_last_post_time($timezone, 'date', $post_type);
    /**
     * Filters the most recent time that a post on the site was published.
     *
     * @since 2.3.0
     * @since 5.5.0 Added the `$post_type` parameter.
     *
     * @param string|false $lastpostdate The most recent time that a post was published,
     *                                   in 'Y-m-d H:i:s' format. False on failure.
     * @param string       $timezone     Location to use for getting the post published date.
     *                                   See get_lastpostdate() for accepted `$timezone` values.
     * @param string       $post_type    The post type to check.
     */
    return apply_filters('get_lastpostdate', $lastpostdate, $timezone, $post_type);
}

WordPress Version: .10

/**
 * Retrieves the most recent time that a post on the site was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. 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'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The date of the last post, or false on failure.
 */
function get_lastpostdate($timezone = 'server', $post_type = 'any')
{
    /**
     * Filters the most recent time that a post on the site was published.
     *
     * @since 2.3.0
     *
     * @param string|false $date     Date the last post was published. False on failure.
     * @param string       $timezone Location to use for getting the post published date.
     *                               See get_lastpostdate() for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date', $post_type), $timezone);
}

WordPress Version: 5.3

/**
 * Retrieves the most recent time that a post on the site was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. 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'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The date of the last post.
 */
function get_lastpostdate($timezone = 'server', $post_type = 'any')
{
    /**
     * Filters the most recent time that a post on the site was published.
     *
     * @since 2.3.0
     *
     * @param string $date     Date the last post was published.
     * @param string $timezone Location to use for getting the post published date.
     *                         See get_lastpostdate() for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date', $post_type), $timezone);
}

WordPress Version: 4.6

/**
 * Retrieve the date that the last post was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. Accepts 'server', 'blog', or 'gmt'.
 *                          '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'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The date of the last post.
 */
function get_lastpostdate($timezone = 'server', $post_type = 'any')
{
    /**
     * Filters the date the last post was published.
     *
     * @since 2.3.0
     *
     * @param string $date     Date the last post was published.
     * @param string $timezone Location to use for getting the post published date.
     *                         See get_lastpostdate() for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date', $post_type), $timezone);
}

WordPress Version: 4.4

/**
 * Retrieve the date that the last post was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 * @since 4.4.0 The `$post_type` argument was added.
 *
 * @param string $timezone  Optional. The timezone for the timestamp. Accepts 'server', 'blog', or 'gmt'.
 *                          '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'.
 * @param string $post_type Optional. The post type to check. Default 'any'.
 * @return string The date of the last post.
 */
function get_lastpostdate($timezone = 'server', $post_type = 'any')
{
    /**
     * Filter the date the last post was published.
     *
     * @since 2.3.0
     *
     * @param string $date     Date the last post was published.
     * @param string $timezone Location to use for getting the post published date.
     *                         See {@see get_lastpostdate()} for accepted `$timezone` values.
     */
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date', $post_type), $timezone);
}

WordPress Version: 4.0

/**
 * Retrieve the date that the last post was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 *
 * @param string $timezone The location to get the time. Accepts 'gmt', 'blog',
 *                         or 'server'. Default 'server'.
 * @return string The date of the last post.
 */
function get_lastpostdate($timezone = 'server')
{
    /**
     * Filter the date the last post was published.
     *
     * @since 2.3.0
     *
     * @param string $date     Date the last post was published. Likely values are 'gmt',
     *                         'blog', or 'server'.
     * @param string $timezone Location to use for getting the post published date.
     */
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date'), $timezone);
}

WordPress Version: 3.9

/**
 * Retrieve the date that the last post was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 *
 * @param string $timezone The location to get the time. Can be 'gmt', 'blog', or 'server'.
 * @return string The date of the last post.
 */
function get_lastpostdate($timezone = 'server')
{
    /**
     * Filter the date the last post was published.
     *
     * @since 2.3.0
     *
     * @param string $date     Date the last post was published. Likely values are 'gmt',
     *                         'blog', or 'server'.
     * @param string $timezone Location to use for getting the post published date.
     */
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date'), $timezone);
}

WordPress Version: 3.7

/**
 * Retrieve the date that the last post was published.
 *
 * The server timezone is the default and is the difference between GMT and
 * server time. The 'blog' value is the date when the last post was posted. The
 * 'gmt' is when the last post was posted in GMT formatted date.
 *
 * @since 0.71
 *
 * @uses apply_filters() Calls 'get_lastpostdate' filter
 *
 * @param string $timezone The location to get the time. Can be 'gmt', 'blog', or 'server'.
 * @return string The date of the last post.
 */
function get_lastpostdate($timezone = 'server')
{
    return apply_filters('get_lastpostdate', _get_last_post_time($timezone, 'date'), $timezone);
}