the_date

Выводит дату публикации поста или группы постов (опубликованные в один день).

Дата публикации группы постов означает, что для постов опубликованных в одни день, дата выводиться только для первого поста. Т.е., для каждого следующего поста в цикле, функция проверяет в какой день опубликован этот пост, и если дата текущего поста и предыдущего совпадают, то для этого поста дата не выводиться.

Чтобы выводить дату для всех постов (с версии 3.0) нужно использовать Теги шаблонов: the_time() или get_the_date().

Функция the_date() предназначена для использования внутри Цикла WordPress.

Хуки из функции:
the_date

Использование

<?php the_date( $format, $before, $after, $echo ); ?>
$format(строка)
Формат даты (в PHP). Например, j F Y выведет “6 ноября 2011”. Подробнее смотрите здесь.
По умолчанию: формат установленный в настройках.
$before(строка)
Текст, который нужно написать перед датой.
По умолчанию: “”
$after(строка)
Текст, который нужно написать после даты.
По умолчанию: “”
$echo(логический)
Установите значение в false, если нужно получить результат, а не выводить его на экран.
По умолчанию: true

Примеры

#1. Выведем дату в формате установленном в настройках WordPress:

<p>Пост опубликован: <?php the_date(); ?></p>

#2. Выведем дату в формате 2007-07-23 и обрамим его в тег <h2>:

<?php the_date('Y-m-d', '<h2>', '</h2>'); ?>

Заметки

Влияет на возвращаемое значение условного тега: [is_new_day()](/function/is_new_day ).

Код из


wp-includes/general-template.php

WP 4.7.2

<?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;
	}
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *