Функции шаблона/the date

Оригинал этой страницы на английском здесь. Этот перевод мой.

Описание

Отображает или возвращает дату создания записи, или нескольких записей опубликованных в тот же день.

Важное замечание: При мультипостирования когда есть несколько записей в один день, the_date() отображает дату только для первой записи (то есть первый пример the_date()). Чтобы повторять дату для записей опубликованных под тем же днем, Вы должны использовать функцию шаблона the_time() с дата-специфическим форматом строки.

Эта функция используется в цикле Loop.

Применение

<?php the_date('format', 'before', 'after', echo); ?>

Примеры 

Применение по умолчанию 

Отображение даты создания записи по умолчанию.

<p>Дата создания записи: <?php the_date(); ?></p>

Отображение даты как год, месяц, день 

Отображение даты в формате '2007-07-23' (ex: 2004-11-30), в теге <h2>.

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

Отображение даты из переменной $my_date

Возвращает дату времени в формате тег <h2> и переменная $my_date. Переменная величина затем отображается эхо командой PHP.

<?php $my_date = the_date('', '', '', FALSE); echo $my_date; ?>

Параметры

format 

(строковой) Формат даты времени. По умолчанию отображается конфигурирация созданная в настройках WordPress. Смотреть Формат даты и времени.

before 

(строковой) Текст устанавливаемый до даты. По умлчанию нет.

after 

(строковой) Текст устанавливаемый после даты. По умолчанию нет.

echo 

(логический) Отобразить дату (TRUE), или вернуть дату которую необходимо отобразить PHP (FALSE). По умолчанию TRUE.