the_date()

Отображает или извлекает дату написания текущей записи (один раз на дату)
Функция WordPress
INT 0.71
WordPress Icon

Описание функции

Функция the_date() выводит или возвращает дату написания текущего поста (один раз за дату).

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

the_date( string $format = '', string $before = '', string $after = '', bool $display = true ): string|void

Код выше представляет собой сигнатуру функции the_date() с указанием типов данных для параметров и типа возвращаемого значения. В этом случае функция принимает четыре параметра: $format, $before, $after и $display.

  • $format (строка) — необязательный параметр, определяющий формат даты в формате PHP. По умолчанию используется опция 'date_format'.
  • $before (строка) — необязательный параметр, определяющий вывод перед датой.
  • $after (строка) — необязательный параметр, определяющий вывод после даты.
  • $display (логическое значение) — необязательный параметр, определяющий, нужно ли выводить дату или вернуть ее. По умолчанию установлено значение true.

Функция возвращает строку, если используется возвращение значения.


/**
 * Выводит дату написания текущего поста в формате "d.m.Y", перед датой выводит "Posted on: ", после даты выводит "by Admin".
 */
the_date( 'd.m.Y', 'Posted on: ', 'by Admin' );

В приведенном выше примере функция the_date() используется для вывода даты написания текущего поста в определенном формате. Перед датой выводится текст «Posted on: «, а после даты — «by Admin».

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

Отображение даты публикации поста


the_date();

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

Форматирование даты публикации


the_date('F j, Y');

Параметр $format позволяет задать формат даты публикации. По умолчанию, если параметр не указан, используется формат, заданный в опции ‘date_format’ в настройках WordPress. В данном примере дата будет отформатирована в виде «Месяц день, Год» (например, «Январь 1, 2022»).

Изменение вывода даты публикации


the_date('', 'Published on: ', '', false);

Параметр $before позволяет указать текст, который будет выведен перед датой публикации. В данном примере перед датой будет выведен текст «Published on: «.

Получение даты публикации


$date = get_the_date();
echo $date;

Если необходимо получить дату публикации поста для дальнейшей обработки или вывода в другом месте, можно воспользоваться функцией get_the_date(). Она возвращает дату публикации текущего поста в виде строки. В данном примере дата будет сохранена в переменную $date и выведена на экран.

Вопросы и ответы

Как изменить формат вывода даты?

Функция the_date() позволяет изменить формат вывода даты, используя параметр $format. По умолчанию, формат даты берется из опции ‘date_format’.


// Пример изменения формата вывода даты
the_date('F j, Y');

Как добавить текст перед датой?

Для добавления текста перед датой используется параметр $before. По умолчанию, перед датой ничего не выводится.


// Пример добавления текста перед датой
the_date('', 'Posted on: ');

Как добавить текст после даты?

Для добавления текста после даты используется параметр $after. По умолчанию, после даты ничего не выводится.


// Пример добавления текста после даты
the_date('', '', ' (last updated)');

Как получить дату без вывода на экран?

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

$date = get_the_date();
echo $date;

Как изменить формат даты только для функции the_date()?

По умолчанию, формат даты для функции the_date() берется из опции ‘date_format’. Можно изменить формат только для этой функции, используя параметр $format.

$format = 'F j, Y';
the_date($format);

Как вывести дату только один раз для нескольких постов с одной датой?

Если несколько постов имеют одинаковую дату, функция the_date() будет выводить дату только один раз. Для вывода даты для каждого поста, можно использовать функцию get_the_date() внутри цикла.

while (have_posts()) {
    the_post();
    $date = get_the_date();
    echo $date;
}

Как вывести дату только для определенного типа постов?

Для вывода даты только для определенного типа постов, необходимо использовать функцию the_date() внутри цикла WordPress и указать параметр $format со значением формата даты, а также параметр $before и $after для вывода дополнительного текста перед и после даты.


<?php
$args = array(
    'post_type' => 'custom_post_type',
    'posts_per_page' => 5
);
$query = new WP_Query($args);
if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        the_date('F j, Y', '<p>Published on: ', '</p>');
    }
}
wp_reset_postdata();
?>

Как вывести дату только для определенной категории постов?

Для вывода даты только для определенной категории постов, необходимо использовать функцию the_date() внутри цикла WordPress и указать параметр $format со значением формата даты, а также параметр $before и $after для вывода дополнительного текста перед и после даты.


<?php
$args = array(
    'category_name' => 'news',
    'posts_per_page' => 5
);
$query = new WP_Query($args);
if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        the_date('F j, Y', '<p>Published on: ', '</p>');
    }
}
wp_reset_postdata();
?>

Как вывести дату только для определенного автора постов?

Для вывода даты только для определенного автора постов, необходимо использовать функцию the_date() внутри цикла WordPress и указать параметр $format со значением формата даты, а также параметр $before и $after для вывода дополнительного текста перед и после даты.


<?php
$args = array(
    'author' => 1,
    'posts_per_page' => 5
);
$query = new WP_Query($args);
if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        the_date('F j, Y', '<p>Published on: ', '</p>');
    }
}
wp_reset_postdata();
?>

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

Связанные элементы

  • Функция get_the_date(): Возвращает дату написания текущего поста в формате, указанном в настройках WordPress.
  • Функция the_time(): Выводит время написания текущего поста в формате, указанном в настройках WordPress.
  • Функция get_the_time(): Возвращает время написания текущего поста в формате, указанном в настройках WordPress.
  • Функция the_modified_date(): Выводит дату последнего изменения текущего поста в формате, указанном в настройках WordPress.
  • Функция get_the_modified_date(): Возвращает дату последнего изменения текущего поста в формате, указанном в настройках WordPress.
  • Функция the_modified_time(): Выводит время последнего изменения текущего поста в формате, указанном в настройках WordPress.
  • Функция get_the_modified_time(): Возвращает время последнего изменения текущего поста в формате, указанном в настройках WordPress.
  • Хук the_date: Позволяет изменить вывод даты написания текущего поста.
  • Хук the_time: Позволяет изменить вывод времени написания текущего поста.
  • Хук the_modified_date: Позволяет изменить вывод даты последнего изменения текущего поста.
Обсуждение