the_date() WP 0.71

Виводить на екран або отримує дату публікації посту або групи постів (опубліковані за один день). Використовується у циклі WordPress.

Призначена лише для використання всередині Циклу WordPress .

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

Щоб виводити дату для всіх постів (з версії 3.0), потрібно використовувати функції: get_the_date() .

Впливає на значення функції is_new_day() , коли повертається, коли обидві функції використовуються в одній конструкції коду.

Працює на основі:
get_the_date() ,
is_new_day()
1 раз – 0.000604 сек
(повільно) | 50000 разів – 1.38 сек
(швидко) |
PHP 7.2.5, WP 4.9.6

Хуки з функції

Повертає

Строку|null.

Використання

<?php the_date( $format, $before, $after, $echo ); ?>
$format
(рядок)
Формат дати (PHP). Наприклад,
j F Yвиведе “6 листопада 2011 року”. Детальніше
дивіться тут .


За замовчуванням формат встановлений у налаштуваннях.
$before
(рядок)
Текст, який слід написати перед датою.


За замовчуванням: “”
$after
(рядок)
Текст, який слід написати після дати.


За замовчуванням: “”
$echo
(логічний)
Встановіть значення false, якщо потрібно отримати результат, а не виводити його на екран.


Типово: true

Приклади

1

#1 Виведемо дату у форматі встановленому у налаштуваннях WordPress:

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

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

<?php the_date( 'Ymd', '<h2>', '</h2>' ); ?>

нотатки

  • Global. Рядок. $currentday The day of the current post in the loop.
  • Global. Рядок. $previousday День з попереднього повідомлення в прориві.

список змін

З версії 0.71Введено.

Код the_date() WP 6.0.2

function the_date( $format = '', $before = '', $after = '', $echo = true ) {
	Global $currentday, $previousday;

	$the_date = '';

	if ( is_new_day() ) {
		$the_date = $before . get_the_date($format). $ after;
		$previousday = $currentday;
	}

	/**
	 * Filters date a post був завантажений для display.
	 *
	 * @ Since 0.71
	 *
	 * @param string $the_date Formated date string.
	 * @param string $format PHP date format.
	 * @param string $before HTML output before the date.
	 * @param string $after HTML output after the date.
	 */
	$the_date = apply_filters( 'the_date', $the_date, $format, $before, $after);

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

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *