Ticket #13771: 13771.3.diff

src/wp-includes/general-template.php

@@ -1420 +1420 @@
 }
 
 /**
- * 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.
  * Modify output with 'get_the_date' filter.
  *
  * @since 3.0.0
  *
- * @param string $d Optional. PHP date format defaults to the date_format option if not specified.
- * @return string Date the current post was written.
+ * @param  string      $d    Optional. PHP date format defaults to the date_format option if not specified.
+ * @param  int|WP_Post $post Optional. WP_Post object or ID. Default is global $post object.
+ * @return string      Date the current post was written.
  */
-function get_the_date( $d = '' ) {
-        $post = get_post();
+function get_the_date( $d = '', $post = 0 ) {
+        $post = get_post( $post );
 
         if ( '' == $d )
                 $the_date = mysql2date( get_option( 'date_format' ), $post->post_date );
         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 );
 }
 
 /**

tests/phpunit/tests/post.php

@@ -865 +865 @@
                 $this->assertEquals( 9, $after_trash_counts->publish );
                 $this->assertNotEquals( $initial_counts->publish, $after_trash_counts->publish );
         }
+
+        /**
+         * @ticket 13771
+         */
+        function test_get_the_date_with_id() {
+                $post_data = array(
+                        'post_status'  => 'public',
+                        'post_content' => rand_str(),
+                        'post_title'   => 'Post test',
+                        'post_date'    => '2014-03-01 16:35:00',
+                );
+                $insert_post_id = wp_insert_post( $post_data );
+
+                $this->assertEquals( 'March 1, 2014', get_the_date( 'F j, Y', $insert_post_id ) );
+        }
 }