显示或检索当前帖子的写入日期(每个日期一次)

原型

the_date( string $d = '', string $before = '', string $after = '', bool $echo = true )

描述

如果当前帖子的日期与前一个输出不同,则仅输出日期。

参数

$d (string) (Optional)  如果未指定,PHP日期格式默认为date_format选项。

$before (string) (Optional)  在日期之前输出。

$after (string) (Optional)  日期后的输出。

$echo (bool) (Optional)  默认是显示。是否回显日期或返回日期。

返回值

(string|void)  检索时的字符串。

源文件

路径:wp-includes/general-template.php

<?php
...
function the_date( $d = '', $before = '', $after = '', $echo = true ) {
	global $currentday, $previousday;
	if ( is_new_day() ) {
		$the_date = $before . get_the_date( $d ) . $after;
		$previousday = $currentday;
		/**
		 * Filters 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;
	}
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/the_date/