Changeset 27380

Timestamp:

03/03/2014 05:59:11 PM (11 years ago)

Author:

nacin

Message:

Let get_the_date() accept a post object.

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

Location:

trunk

Files:

• src/wp-includes/general-template.php (modified) (2 diffs)
• tests/phpunit/tests/post.php (modified) (1 diff)

trunk/src/wp-includes/general-template.php

@@ -1421 +1421 @@
 
 /**
- * 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.
@@ -1428 +1428 @@
  * @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.
  */
-function get_the_date( $d = '' ) {
-    $post = get_post();
-
-    if ( '' == $d )
+function get_the_date( $d = '', $post = null ) {
+    $post = get_post( $post );
+
+    if ( '' == $d ) {
         $the_date = mysql2date( get_option( 'date_format' ), $post->post_date );
-    else
+    } else {
         $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 );
 }
 

trunk/tests/phpunit/tests/post.php

@@ -866 +866 @@
         $this->assertNotEquals( $initial_counts->publish, $after_trash_counts->publish );
     }
+
+    /**
+     * @ticket 13771
+     */
+    function test_get_the_date_with_id() {
+        $post_id = $this->factory->post->create( array( 'post_date' => '2014-03-01 16:35:00' ) );
+        $this->assertEquals( 'March 1, 2014', get_the_date( 'F j, Y', $post_id ) );
+    }
 }