diff --git a/wp-includes/general-template.php b/wp-includes/general-template.php index c7139c52db..99ae18b044 100644 --- a/wp-includes/general-template.php +++ b/wp-includes/general-template.php @@ -2254,26 +2254,37 @@ function the_modified_date( $d = '', $before = '', $after = '', $echo = true ) { * Retrieve the date on which the post was last modified. * * @since 2.1.0 + * @since 4.6.0 The `$post` parameter was added. * - * @param string $d Optional. PHP date format. Defaults to the "date_format" option - * @return string + * @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 = '') { - 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); +function get_the_modified_date( $d = '', $post = null ) { + $post = get_post( $post ); + + if ( ! $post ) { + return false; + } + + if ( 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 The `$post` parameter was added. * - * @param string $the_time The formatted date. - * @param string $d PHP date format. Defaults to value specified in - * 'date_format' option. + * @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 ); + return apply_filters( 'get_the_modified_date', $the_time, $d, $post ); } /** @@ -2397,27 +2408,40 @@ function the_modified_time($d = '') { * Retrieve the time at which the post was last modified. * * @since 2.0.0 + * @since 4.6.0 The `$post` parameter was added. * - * @param string $d Optional Either 'G', 'U', or php date format defaults to the value specified in the time_format option. - * @return string + * @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 = '') { - 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); +function get_the_modified_time( $d = '', $post = null ) { + $post = get_post( $post ); + + if ( ! $post ) { + return false; + } + + if ( 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 The `$post` parameter was added. * * @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 ); + return apply_filters( 'get_the_modified_time', $the_time, $d, $post ); } /** diff --git a/wp-includes/version.php b/wp-includes/version.php index 6a5fd24749..abb4661760 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '4.6-alpha-37737'; +$wp_version = '4.6-alpha-37738'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.