the_date()

the_date( string $format = ”, string $before = ”, strin…

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)

参数 类型 说明
$format (string) 如果未指定,PHP日期格式默认为date_format选项。
$before (string) 日期之前的输出。
$after (string) 日期之后的输出。
$echo (bool) 默认值为“显示”。是回显日期还是返回日期。

源码(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;
	}
}
更新版本 源码位置 使用 被使用
0.71 wp-includes/general-template.php 12 7

笔记(Notes)

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

类别:WordPress 函数手册

本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。

评论 (0)COMMENT

登录 账号发表你的看法,还没有账号?立即免费 注册