is_year() │ WP 1.5.0

Determines whether a year archive page is shown (example.com/2009) — page with posts for a specific year. A conditional tag.

This function is a part of is_date() and is_archive() check, so if you use them together, you should use is_year() before those functions, otherwise is_year() condition will never occur.

Uses: WP_Query::is_year()
1 time — 0.00007 sec (very fast) | 50000 times — 0.01 sec (speed of light)

No Hooks.

Return

true|false. Whether the query is for an existing year archive.

Usage

if( is_year() ){
	// ...
}

Examples

0

#1 Display text only on year archive pages 

if( is_year() ){
	echo 'This is an archive page for year: for example, such link example.com/2009';
}
0

#2 Use of is_archive() and is_year() together in if/else statements 

if( is_year() )
	echo 'This is an year archive page.';
elseif( is_archive() )
	echo 'An archive page: day, month, category, tag etc.';
else
	echo 'This is not an year archive page';

So is_archive() should follow is_year(), otherwise is_year() condition will never occur.

Notes

  • Global. WP_Query. $wp_query WordPress Query object.

Changelog

Since 1.5.0 Introduced.

is_year() code WP 6.7.1

wp-includes/query.php 
function is_year() {
	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_year();
}

Conditional tags (page type and request)

Conditional tags (all)

Queries

Main Functions