Codex

Function Reference/get year link

Contents

Description

Returns the yearly archive URL to a specific year for use in PHP. It does NOT display the URL. If year is set to '', the tag returns the URL for the current year's archive.

Usage

 <?php get_year_link( $year ); ?> 

Parameters

$year
(integer) (optional) The year for the archive. Use '' to assign current year.
Default: None

Examples

Year as Link

Returns the URL for the current year's archive, displaying it as a link in the anchor tag by using the PHP echo command. 

<a href="<?php echo get_year_link(''); ?>">Posts from this year</a>

Year as a variable

Returns URL for the archive year 2003, assigning it to the variable $year03. The variable can then be used elsewhere in a page. 

<?php $year03 = get_year_link(2003); ?>

Using With PHP Variables

PHP code block for use within The Loop: Assigns year to the variable $arc_year. This is used with the get_year_link() tag, which returns the URL as a link to the yearly archive for a post, displaying it within an anchor tag with the PHP echo command. See Formatting Date and Time for info on format strings used in get_the_time() tag. 

<?php $arc_year = get_the_time('Y'); ?>

<a href="<?php echo get_year_link($arc_year); ?>"><?php the_time('Y'); ?> archive</a>

Change Log

Since: 1.5.0

Source File

get_year_link() is located in wp-includes/link-template.php.

Related

the_time, the_date, the_date_xml, the_modified_time, the_modified_date, the_modified_author, single_month_title, get_the_time, get_day_link, get_month_link, get_year_link, get_calendar

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/get_year_link"

Codex Resources