Главное отличие функции the_time()
от the_date() в том, что если дата публикации текущего поста в цикле равна дате публикации предыдущего поста в цикле, то the_date() не будет возвращать / выводить ничего. Поэтому функцию the_time()
можно использовать и для вывода даты тоже.
the_time( $format = '' )
Параметры
- $format
- (строка) Формат, в котором нужно вывести дату/время. Например значение переменной может быть
Y-m-d
(2020-01-30). Больше доступных форматов вы можете найти в официальной документации PHP.
Формат времени по умолчанию – это значение опции time_format
в админке в Настройки > Общие.
Примеры
Отображаем время в формате даты j F Y
(15 мая 2021), заменяя при этом использование функции the_date()
.
the_time( 'j F Y' );
Отображаем время в соответствии со стандартными настройками в админке WordPress:
echo 'Опубликовано: '; the_time();
Иногда может понадобиться выводить время в 12-и или 24-и часовом формате, тогда это можно сделать при помощи следующих значений параметра $format
.
the_time( 'g:i a' ); // 10:52 pm the_time( 'G:i' ); // 22:52
Можно сразу же отобразить и дату и время:
the_time( 'j F Y в G:i' ); // 15 мая 2021 в 7:42
Фильтр the_time
Перед тем, как вывести значение время, его можно отфильтровать хуком the_time
. Например давайте выведем «Сегодня», если дата совпадает с сегодняшней датой.
add_filter( 'the_time', 'true_filter_time_callback', 25, 2 ); function true_filter_time_callback( $time, $format ) { // если используется формат даты (а не времени) // и если текущая дата равна выводимой if( 'j F Y' === $format && date( 'j F Y' ) == $time ) { $time = 'Сегодня'; } return $time; }