get_the_modified_date() WordPress Function

The get_the_modified_date() function is used to return the date when a post was last modified.

get_the_modified_date( string $format = '', int|WP_Post $post = null ) #

Retrieve the date on which the post was last modified.


Parameters

$format

(string)(Optional) PHP date format. Defaults to the 'date_format' option.

Default value: ''

$post

(int|WP_Post)(Optional) Post ID or WP_Post object. Default current post.

Default value: null


Top ↑

Return

(string|int|false) Date the current post was modified. False on failure.


Top ↑

Source

File: wp-includes/general-template.php

2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
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 );
}


Top ↑

Changelog

Changelog
VersionDescription
4.6.0Added the $post parameter.
2.1.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by the Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More
Show More