WordPress.org

Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/get month link

Description

Returns the monthly archive URL to a specific year and month for use in PHP. It does NOT display the URL. If year and month parameters are set to '', the tag returns the URL for the current month's archive.

In a Plugin or Theme, it can be used as early as the setup_theme Action. Any earlier usage, including plugins_loaded, generates a Fatal Error.

Usage

 <?php get_month_link$year$month ); ?> 

Parameters

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

Examples

Month Archive as Link

Returns the URL to the current month's archive as a link by displaying it within an anchor tag with the PHP echo command.

<a href="<?php echo get_month_link('', ''); ?>">All posts this month</a>

Assigning Specific Month to Variable

Returns URL to the archive for October 2004, assigning it to the variable $oct_04. The variable can then be used elsewhere in a page.

<?php $oct_04 = get_month_link('2004', '10'); ?>

Use With PHP Variables

PHP code block for use within The Loop: Assigns year and month of a post to the variables $arc_year and $arc_month. These are used with the get_month_link() tag, which returns the URL as a link to the monthly archive for that 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 $archive_year  = get_the_time('Y'); ?>
<?php $archive_month = get_the_time('m'); ?>

<a href="<?php echo get_month_link( $archive_year, $archive_month ); ?>">
Archive for <?php the_time('F Y'); ?>
</a>

Changelog

Since: 1.0.0

Source File

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

Related

get_calendar(), get_day_link(), get_month_link(), get_the_date(), get_the_time(), get_year_link(), single_month_title(), the_date(), the_date_xml(), the_modified_date(), get_the_modified_date(), the_modified_time(), get_the_modified_time(), the_time()

See also index of Function Reference and index of Template Tags.