is_date() WP 1.5.0

Determines whether the date archive page is displayed. Conditional tag.

This function is part of is_archive() check and contains in itself: is_day(), is_month(), is_year() and etc. (see example 2)

No Hooks.

Return

true/false. Whether the query is for an existing date archive.

Usage

is_date();

Examples

#1 Basic usage

if( is_date() )
	echo "It's an archive by date";
else
	echo "It's not an archive by date";

#2 What checks are included in is_date()

is_date() contains in itself functions is_day(), is_month(), is_year() and etc.

This example demonstrates how not to do:

if( is_date() )
	echo "It's an archive by date";
elseif( is_day() )
	echo "It's an archive by day";
else
	echo "This is something else";

In this example, the is_day() condition will never be met. It needs to be checked before is_date().

Notes

• Global. WP_Query. $wp_query WordPress Query object.

Changelog

Code of is_date() is date ^{WP 5.6}

<?php
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();
}

Related Functions

From tag: Conditional tags (page type and request)

More from tag: Conditional tags (all)

More from category: Queries

More from Template Tags: Main Functions