get_the_modified_date

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

WordPress Version: 6.1

/**
 * Retrieves the date on which the post was last modified.
 *
 * @since 2.1.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. PHP date format. Defaults to the 'date_format' option.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|int|false Date the current post was modified. False on failure.
 */
function get_the_modified_date($format = '', $post = null)
{
    $post = get_post($post);
    if (!$post) {
        // For backward compatibility, failures go through the filter below.
        $the_time = false;
    } else {
        $_format = (!empty($format)) ? $format : get_option('date_format');
        $the_time = get_post_modified_time($_format, false, $post, true);
    }
    /**
     * Filters the date a post was last modified.
     *
     * @since 2.1.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|int|false $the_time The formatted date or false if no post is found.
     * @param string           $format   PHP date format.
     * @param WP_Post|null     $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_date', $the_time, $format, $post);
}

WordPress Version: 5.6

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. PHP date format. Defaults to the 'date_format' option.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|int|false Date the current post was modified. False on failure.
 */
function get_the_modified_date($format = '', $post = null)
{
    $post = get_post($post);
    if (!$post) {
        // For backward compatibility, failures go through the filter below.
        $the_time = false;
    } else {
        $_format = (!empty($format)) ? $format : get_option('date_format');
        $the_time = get_post_modified_time($_format, false, $post, true);
    }
    /**
     * Filters the date a post was last modified.
     *
     * @since 2.1.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|int|false $the_time The formatted date or false if no post is found.
     * @param string           $format   PHP date format.
     * @param WP_Post|null     $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_date', $the_time, $format, $post);
}

WordPress Version: 5.1

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. PHP date format defaults to the date_format option if not specified.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|false Date the current post was modified. False on failure.
 */
function get_the_modified_date($format = '', $post = null)
{
    $post = get_post($post);
    if (!$post) {
        // For backward compatibility, failures go through the filter below.
        $the_time = false;
    } else {
        $_format = (!empty($format)) ? $format : get_option('date_format');
        $the_time = get_post_modified_time($_format, false, $post, true);
    }
    /**
     * Filters the date a post was last modified.
     *
     * @since 2.1.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|bool  $the_time The formatted date or false if no post is found.
     * @param string       $format   PHP date format. Defaults to value specified in
     *                               'date_format' option.
     * @param WP_Post|null $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_date', $the_time, $format, $post);
}

WordPress Version: 5.4

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. PHP date format defaults to the date_format option if not specified.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|false Date the current post was modified. False on failure.
 */
function get_the_modified_date($format = '', $post = null)
{
    $post = get_post($post);
    if (!$post) {
        // For backward compatibility, failures go through the filter below.
        $the_time = false;
    } elseif (empty($format)) {
        $the_time = get_post_modified_time(get_option('date_format'), false, $post, true);
    } else {
        $the_time = get_post_modified_time($format, false, $post, true);
    }
    /**
     * Filters the date a post was last modified.
     *
     * @since 2.1.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|bool  $the_time The formatted date or false if no post is found.
     * @param string       $format   PHP date format. Defaults to value specified in
     *                               'date_format' option.
     * @param WP_Post|null $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_date', $the_time, $format, $post);
}

WordPress Version: 4.9

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $d    Optional. PHP date format defaults to the date_format option if not specified.
 * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
 * @return false|string Date the current post was modified. False on failure.
 */
function get_the_modified_date($d = '', $post = null)
{
    $post = get_post($post);
    if (!$post) {
        // For backward compatibility, failures go through the filter below.
        $the_time = false;
    } elseif (empty($d)) {
        $the_time = get_post_modified_time(get_option('date_format'), false, $post, true);
    } else {
        $the_time = get_post_modified_time($d, false, $post, true);
    }
    /**
     * Filters the date a post was last modified.
     *
     * @since 2.1.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|bool  $the_time The formatted date or false if no post is found.
     * @param string       $d        PHP date format. Defaults to value specified in
     *                               'date_format' option.
     * @param WP_Post|null $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_date', $the_time, $d, $post);
}

WordPress Version: 4.6

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $d    Optional. PHP date format defaults to the date_format option if not specified.
 * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
 * @return false|string Date the current post was modified. False on failure.
 */
function get_the_modified_date($d = '', $post = null)
{
    $post = get_post($post);
    if (!$post) {
        // For backward compatibility, failures go through the filter below.
        $the_time = false;
    } elseif (empty($d)) {
        $the_time = get_post_modified_time(get_option('date_format'), false, $post, true);
    } else {
        $the_time = get_post_modified_time($d, false, $post, true);
    }
    /**
     * Filters the date a post was last modified.
     *
     * @since 2.1.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string  $the_time The formatted date.
     * @param string  $d        PHP date format. Defaults to value specified in
     *                          'date_format' option.
     * @param WP_Post $post     WP_Post object.
     */
    return apply_filters('get_the_modified_date', $the_time, $d, $post);
}

WordPress Version: 3.9

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 *
 * @param string $d Optional. PHP date format. Defaults to the "date_format" option
 * @return string
 */
function get_the_modified_date($d = '')
{
    if ('' == $d) {
        $the_time = get_post_modified_time(get_option('date_format'), null, null, true);
    } else {
        $the_time = get_post_modified_time($d, null, null, true);
    }
    /**
     * Filter the date a post was last modified.
     *
     * @since 2.1.0
     *
     * @param string $the_time The formatted date.
     * @param string $d        PHP date format. Defaults to value specified in
     *                         'date_format' option.
     */
    return apply_filters('get_the_modified_date', $the_time, $d);
}

WordPress Version: 3.7

/**
 * Retrieve the date on which the post was last modified.
 *
 * @since 2.1.0
 *
 * @param string $d Optional. PHP date format. Defaults to the "date_format" option
 * @return string
 */
function get_the_modified_date($d = '')
{
    if ('' == $d) {
        $the_time = get_post_modified_time(get_option('date_format'), null, null, true);
    } else {
        $the_time = get_post_modified_time($d, null, null, true);
    }
    return apply_filters('get_the_modified_date', $the_time, $d);
}