Ticket #52322: 52322.3.diff

src/wp-includes/comment-template.php

@@ -1030 +1030 @@
  * Retrieves the comment time of the current comment.
  *
  * @since 1.5.0
+ * @since 6.2.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
  *
  * @param string $format    Optional. PHP time format. Defaults to the 'time_format' option.
  * @param bool   $gmt       Optional. Whether to use the GMT date. Default false.
  * @param bool   $translate Optional. Whether to translate the time (for use in feeds).
  *                          Default true.
+ * @param int|WP_Comment $comment_ID WP_Comment or ID of the comment for which to get the date.
  * @return string The formatted time.
  */
-function get_comment_time( $format = '', $gmt = false, $translate = true ) {
-        $comment = get_comment();
+function get_comment_time( $format = '', $gmt = false, $translate = true, $comment_ID = 0 ) {
+        $comment = get_comment( $comment_ID );
 
         $comment_date = $gmt ? $comment->comment_date_gmt : $comment->comment_date;
 
@@ -1050 +1052 @@
          * Filters the returned comment time.
          *
          * @since 1.5.0
+         * @since 6.2.0 Added `$comment_ID` so that developer can get a direct comment id
          *
          * @param string|int $date      The comment time, formatted as a date string or Unix timestamp.
          * @param string     $format    PHP date format.
          * @param bool       $gmt       Whether the GMT date is in use.
          * @param bool       $translate Whether the time is translated.
          * @param WP_Comment $comment   The comment object.
+         * @param string     $comment_ID   The comment ID as a numeric string.
          */
-        return apply_filters( 'get_comment_time', $date, $format, $gmt, $translate, $comment );
+        return apply_filters( 'get_comment_time', $date, $format, $gmt, $translate, $comment, $comment_ID );
 }
 
 /**
  * Displays the comment time of the current comment.
  *
  * @since 0.71
+ * @since 6.2.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.
  *
  * @param string $format Optional. PHP time format. Defaults to the 'time_format' option.
+ * @param int|WP_Comment $comment_ID WP_Comment or ID of the comment for which to get the date.
  */
-function comment_time( $format = '' ) {
-        echo get_comment_time( $format );
+function comment_time( $format = '', $comment_ID = 0 ) {
+        echo get_comment_time( $format, false, true, $comment_ID );
 }
 
 /**