IS_DATE() │ WP 1.5.0

Определение

Функция IS_DATE() определяет, отображается ли страница архива по дате. Это условный тег, который помогает в разработке тем и плагинов для WordPress.

Что входит в IS_DATE()?

Эта функция является частью проверки is_archive() и включает в себя такие функции, как:

• is_day()
• is_month()
• is_year()

Производительность

• Вызов is_date() занимает всего 0.00006 секунд (очень быстро).
• При многократном использовании (50,000 раз) время выполнения составит 0.02 секунды.

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

Функция возвращает:

• true, если запрашивается существующий архив по дате.
• false, если архив не существует.

Как использовать

Чтобы использовать функцию, просто вызовите её в коде:

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().

Дополнительный пример

Вы можете добавить свой собственный пример использования функции is_date(), чтобы продемонстрировать, как она работает в вашем проекте.

Примечания

• Функция является глобальной. Вы можете получить доступ к объекту запроса WordPress через глобальную переменную $wp_query.

Изменения

Функция IS_DATE() была добавлена в версии 1.5.0 WordPress.

Код функции

Функция is_date() выглядит так:

function is_date() {
global $wp_query;

if ( ! isset( $wp_query ) ) {
    _doing_it_wrong( __FUNCTION__, __( 'Условные теги запроса не работают до выполнения запроса. Они всегда возвращают false до этого.' ), '3.1.0' );
    return false;
}

return $wp_query->is_date();

}

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

Вот некоторые другие условные теги, которые могут вас заинтересовать:

• is_404() - проверяет, является ли страница страницей ошибки 404.
• is_admin() - проверяет, находитесь ли вы в административной панели.
• is_category() - проверяет, является ли страница категорий.
• is_single() - проверяет, отображается ли одиночная запись.

Заключение

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