is_date() WP 1.5.0
Срабатывает когда отображается страница архива по дате. Условный тег.
Функция является частью проверки is_archive() и включает в себя проверки функций: is_day(), is_month(), is_year() и т.д. (см. пример 2)
Работает на основе: WP_Query::is_date()
1 раз — 0.00006 сек (очень быстро) | 50000 раз — 0.02 сек (скорость света)
Хуков нет.
Возвращает
true или false. Зависит от выполнения или не выполнения условия.
Использование
if( is_date() ){ // ... }
Примеры
#1. Обычный пример проверки страницы архива по дате:
if( is_date() ) echo "Это архив по дате"; else echo "Это не страница архива по дате";
#2. Какие проверки входят в is_date()
В функцию is_date() входят проверки функций is_day(), is_month(), is_year().
Пример с ошибкой, как нельзя строить логическую цепочку:
if( is_date() ) echo "Это архива по дате"; elseif( is_day() ) echo "Это архив по дню"; else echo "Это не страница архива по дате";
В этом примере условие is_day() не будут выполняться никогда. Его нужно проверять до is_date().
Заметки
- Global. WP_Query. $wp_query WordPress Query object.
Список изменений
С версии 1.5.0 | Введена. |
Код is_date() is date WP 5.6.2
function is_date() {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
return false;
}
return $wp_query->is_date();
}