the_date( string $format = ”, string $before = ”, string $after = ”, bool $echo = true )

显示或检索当前文章的撰写日期（每个日期一次）
Display or Retrieve the date the current post was written (once per date)

目录锚点：#说明#参数#源码#笔记

---

说明（Description）

仅当当前帖子的日期与前一个输出的日期不同时才会输出日期。i、 e.只有一个日期列表将显示循环中每天显示的帖子价值，即使每个帖子调用函数多次。HTML输出可以用“the_date”过滤。日期字符串输出可以用“getthedate”过滤。

参数（Parameters）

源码（Source）

/**
 * Display or Retrieve the date the current post was written (once per date)
 *
 * Will only output the date if the current post's date is different from the
 * previous one output.
 *
 * i.e. Only one date listing will show per day worth of posts shown in the loop, even if the
 * function is called several times for each post.
 *
 * HTML output can be filtered with 'the_date'.
 * Date string output can be filtered with 'get_the_date'.
 *
 * @since 0.71
 *
 * @global string|int|bool $currentday
 * @global string|int|bool $previousday
 *
 * @param string $d      Optional. PHP date format defaults to the date_format option if not specified.
 * @param string $before Optional. Output before the date.
 * @param string $after  Optional. Output after the date.
 * @param bool   $echo   Optional, default is display. Whether to echo the date or return it.
 * @return string|void String if retrieving.
 */
function the_date( $d = '', $before = '', $after = '', $echo = true ) {
	global $currentday, $previousday;

	if ( $currentday != $previousday ) {
		$the_date = $before . get_the_date( $d ) . $after;
		$previousday = $currentday;

		/**
		 * Filter the date a post was published for display.
		 *
		 * @since 0.71
		 *
		 * @param string $the_date The formatted date string.
		 * @param string $d        PHP date format. Defaults to 'date_format' option
		 *                         if not specified.
		 * @param string $before   HTML output before the date.
		 * @param string $after    HTML output after the date.
		 */
		$the_date = apply_filters( 'the_date', $the_date, $d, $before, $after );

		if ( $echo )
			echo $the_date;
		else
			return $the_date;
	}
}

笔记（Notes）

标题中的日期为年、月、日