Функция THE_DATE() в WordPress: обзор, использование и примеры

# Функция THE_DATE() в WordPress

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

## Как работает функция

Функция the_date() используется только в цикле WordPress (WordPress Loop). При этом, если несколько записей были опубликованы в один и тот же день, дата будет отображаться только для первой записи. Если функция вызывается для каждой следующей записи, то она проверяет, когда была опубликована текущая запись. Если дата совпадает с датой предыдущей записи, текущая дата не будет показана.

Вывод в HTML можно отфильтровать с помощью хука the_date. Символ даты также можно отфильтровать с помощью функции get_the_date().

### Возвращаемое значение

Функция возвращает строку с датой или null, если результат отображается на экране.

## Использование функции

Функция принимается с несколькими параметрами:

```php

• $d (строка): формат даты в PHP. Если не указан, используется настройка date_format. Посмотрите возможные форматы.

  • По умолчанию: ''

• $before (строка): текст/HTML перед датой.

  • По умолчанию: ''

• $after (строка): текст/HTML после даты.

  • По умолчанию: ''

• $echo (boolean): нужно ли выводить дату на экран или вернуть её. true — выводит результат.

  • По умолчанию: true

Примеры использования

Пример 1: Отображение даты в формате настроек WordPress

Опубликовано: 

Пример 2: Отображение даты в формате YYYY-MM-DD и оборачивание её в тег <h2>

', ''); ?>

Это выведет что-то вроде: <h2>2018-05-12</h2>.

Пример 3: Возврат даты в переменную, но без отображения

$date = the_date('Y-m-d', '', '', false); //> 2018-05-12

Важные заметки

• Глобальные переменные:
  • $currentday: день текущей записи в цикле.
  • $previousday: день предыдущей записи в цикле.

Изменения функции

Функция была введена в версии 0.71.

Код функции

Функция реализована следующим образом в ф��йле wp-includes/general-template.php:

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

$the_date = '';

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

$the_date = apply_filters('the_date', $the_date, $format, $before, $after);

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

}

Связанные функции

Некоторые другие функции, с которыми стоит ознакомиться:

• get_the_author()
• get_the_content()
• the_time()
• the_excerpt()
• the_permalink()

Функция the_date() является полезным инструментом для отображения даты публикации записей в WordPress. Используйте её, чтобы сделать ваш контент более информативным для читателей!