get_the_modified_time

The timeline below displays how wordpress function get_the_modified_time 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 time at which the post was last modified.
 *
 * @since 2.0.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. Format to use for retrieving the time the post
 *                            was modified. Accepts 'G', 'U', or PHP date format.
 *                            Defaults to the 'time_format' option.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|int|false Formatted date string or Unix timestamp. False on failure.
 */
function get_the_modified_time($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('time_format');
        $the_time = get_post_modified_time($_format, false, $post, true);
    }
    /**
     * Filters the localized time a post was last modified.
     *
     * @since 2.0.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|int|false $the_time The formatted time or false if no post is found.
     * @param string           $format   Format to use for retrieving the time the post
     *                                   was modified. Accepts 'G', 'U', or PHP date format.
     * @param WP_Post|null     $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_time', $the_time, $format, $post);
}

WordPress Version: 5.6

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. Format to use for retrieving the time the post
 *                            was modified. Accepts 'G', 'U', or PHP date format.
 *                            Defaults to the 'time_format' option.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|int|false Formatted date string or Unix timestamp. False on failure.
 */
function get_the_modified_time($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('time_format');
        $the_time = get_post_modified_time($_format, false, $post, true);
    }
    /**
     * Filters the localized time a post was last modified.
     *
     * @since 2.0.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|int|false $the_time The formatted time or false if no post is found.
     * @param string           $format   Format to use for retrieving the time the post
     *                                   was modified. Accepts 'G', 'U', or PHP date format.
     * @param WP_Post|null     $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_time', $the_time, $format, $post);
}

WordPress Version: 5.1

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. Format to use for retrieving the time the post
 *                            was modified. Either 'G', 'U', or PHP date format defaults
 *                            to the value specified in the time_format option. Default empty.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|false Formatted date string or Unix timestamp. False on failure.
 */
function get_the_modified_time($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('time_format');
        $the_time = get_post_modified_time($_format, false, $post, true);
    }
    /**
     * Filters the localized time a post was last modified.
     *
     * @since 2.0.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|bool  $the_time The formatted time or false if no post is found.
     * @param string       $format   Format to use for retrieving the time the post was
     *                               written. Accepts 'G', 'U', or PHP date format. Defaults
     *                               to value specified in 'time_format' option.
     * @param WP_Post|null $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_time', $the_time, $format, $post);
}

WordPress Version: 5.4

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $format Optional. Format to use for retrieving the time the post
 *                            was modified. Either 'G', 'U', or PHP date format defaults
 *                            to the value specified in the time_format option. Default empty.
 * @param int|WP_Post $post   Optional. Post ID or WP_Post object. Default current post.
 * @return string|false Formatted date string or Unix timestamp. False on failure.
 */
function get_the_modified_time($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('time_format'), false, $post, true);
    } else {
        $the_time = get_post_modified_time($format, false, $post, true);
    }
    /**
     * Filters the localized time a post was last modified.
     *
     * @since 2.0.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|bool  $the_time The formatted time or false if no post is found.
     * @param string       $format   Format to use for retrieving the time the post was
     *                               written. Accepts 'G', 'U', or PHP date format. Defaults
     *                               to value specified in 'time_format' option.
     * @param WP_Post|null $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_time', $the_time, $format, $post);
}

WordPress Version: 4.9

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $d     Optional. Format to use for retrieving the time the post
 *                           was modified. Either 'G', 'U', or php date format defaults
 *                           to the value specified in the time_format option. Default empty.
 * @param int|WP_Post $post  Optional. Post ID or WP_Post object. Default current post.
 * @return false|string Formatted date string or Unix timestamp. False on failure.
 */
function get_the_modified_time($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('time_format'), false, $post, true);
    } else {
        $the_time = get_post_modified_time($d, false, $post, true);
    }
    /**
     * Filters the localized time a post was last modified.
     *
     * @since 2.0.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string|bool  $the_time The formatted time or false if no post is found.
     * @param string       $d        Format to use for retrieving the time the post was
     *                               written. Accepts 'G', 'U', or php date format. Defaults
     *                               to value specified in 'time_format' option.
     * @param WP_Post|null $post     WP_Post object or null if no post is found.
     */
    return apply_filters('get_the_modified_time', $the_time, $d, $post);
}

WordPress Version: 4.6

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 * @since 4.6.0 Added the `$post` parameter.
 *
 * @param string      $d     Optional. Format to use for retrieving the time the post
 *                           was modified. Either 'G', 'U', or php date format defaults
 *                           to the value specified in the time_format option. Default empty.
 * @param int|WP_Post $post  Optional. Post ID or WP_Post object. Default current post.
 * @return false|string Formatted date string or Unix timestamp. False on failure.
 */
function get_the_modified_time($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('time_format'), false, $post, true);
    } else {
        $the_time = get_post_modified_time($d, false, $post, true);
    }
    /**
     * Filters the localized time a post was last modified.
     *
     * @since 2.0.0
     * @since 4.6.0 Added the `$post` parameter.
     *
     * @param string $the_time The formatted time.
     * @param string $d        Format to use for retrieving the time the post was
     *                         written. Accepts 'G', 'U', or php date format. Defaults
     *                         to value specified in 'time_format' option.
     * @param WP_Post $post    WP_Post object.
     */
    return apply_filters('get_the_modified_time', $the_time, $d, $post);
}

WordPress Version: 3.9

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 *
 * @param string $d Optional Either 'G', 'U', or php date format defaults to the value specified in the time_format option.
 * @return string
 */
function get_the_modified_time($d = '')
{
    if ('' == $d) {
        $the_time = get_post_modified_time(get_option('time_format'), null, null, true);
    } else {
        $the_time = get_post_modified_time($d, null, null, true);
    }
    /**
     * Filter the localized time a post was last modified.
     *
     * @since 2.0.0
     *
     * @param string $the_time The formatted time.
     * @param string $d        Format to use for retrieving the time the post was
     *                         written. Accepts 'G', 'U', or php date format. Defaults
     *                         to value specified in 'time_format' option.
     */
    return apply_filters('get_the_modified_time', $the_time, $d);
}

WordPress Version: 3.7

/**
 * Retrieve the time at which the post was last modified.
 *
 * @since 2.0.0
 *
 * @param string $d Optional Either 'G', 'U', or php date format defaults to the value specified in the time_format option.
 * @return string
 */
function get_the_modified_time($d = '')
{
    if ('' == $d) {
        $the_time = get_post_modified_time(get_option('time_format'), null, null, true);
    } else {
        $the_time = get_post_modified_time($d, null, null, true);
    }
    return apply_filters('get_the_modified_time', $the_time, $d);
}