the_date() WP 0.71
Выводит на экран или получает дату публикации поста или группы постов (опубликованные в один день). Используется в цикле WordPress.
Предназначена только для использования внутри Цикла WordPress.
Дата публикации группы постов означает, что для постов опубликованных в одни день, дата выводиться только для первого поста. Т.е., для каждого следующего поста в цикле, функция проверяет в какой день опубликован этот пост, и если дата текущего поста и предыдущего совпадают, то для этого поста дата не выводиться.
Чтобы выводить дату для всех постов (с версии 3.0) нужно использовать функции: the_time() или 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
Хуки из функции
Использование
<?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>'); ?>
Заметки
- Global. Строка. $currentday The day of the current post in the loop.
- Global. Строка. $previousday The day of the previous post in the loop.
Список изменений
С версии 0.71 | Введена. |
Код the_date() the date WP 5.6
Cвязанные функции
Из метки: loop (Цикл WP)
Еще из метки: date time (дата время)
- comment_date()
- comment_time()
- current_time()
- date_i18n()
- get_comment_date()
- get_comment_time()
- get_date_from_gmt()
- get_gmt_from_date()
Еще из раздела: Записи: посты, страницы, ...
- edit_post_link()
- get_delete_post_link()
- get_edit_post_link()
- get_permalink()
- get_post_field()
- get_post_status()
Еще из тегов шаблона: Записи: посты, страницы, ...
- body_class()
- get_post_format()
- have_posts()
- in_the_loop()
- next_image_link()
- next_post_link()
- next_posts_link()