Let get_the_date() accept a post object.

props tanner-m, adamsilverstein, bigdawggi.
fixes #13771.

Built from https://develop.svn.wordpress.org/trunk@27380


git-svn-id: http://core.svn.wordpress.org/trunk@27229 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Andrew Nacin 2014-03-03 18:00:14 +00:00
parent 690481f8e8
commit f1bcaeb35f

View File

@ -1420,25 +1420,36 @@ function the_date( $d = '', $before = '', $after = '', $echo = true ) {
} }
/** /**
* Retrieve the date the current post was written. * Retrieve the date on which the post was written.
* *
* Unlike the_date() this function will always return the date. * Unlike the_date() this function will always return the date.
* Modify output with 'get_the_date' filter. * Modify output with 'get_the_date' filter.
* *
* @since 3.0.0 * @since 3.0.0
* *
* @param string $d Optional. PHP date format defaults to the date_format option if not specified. * @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 string Date the current post was written. * @return string Date the current post was written.
*/ */
function get_the_date( $d = '' ) { function get_the_date( $d = '', $post = null ) {
$post = get_post(); $post = get_post( $post );
if ( '' == $d ) if ( '' == $d ) {
$the_date = mysql2date( get_option( 'date_format' ), $post->post_date ); $the_date = mysql2date( get_option( 'date_format' ), $post->post_date );
else } else {
$the_date = mysql2date( $d, $post->post_date ); $the_date = mysql2date( $d, $post->post_date );
}
return apply_filters( 'get_the_date', $the_date, $d ); /**
* Filter the date returned from the get_the_date function.
*
* @since 3.0.0
*
* @param string $the_date The formatted date.
* @param string $d The date format.
* @param int|WP_Post $post The post object or id.
*/
return apply_filters( 'get_the_date', $the_date, $d, $post );
} }
/** /**