云策 WordPress 开发者社区

函数文档

get_day_link()

查看官方原文 ↗
💡 云策文档标注

概述

get_day_link() 函数用于获取指定年、月、日的归档页面固定链接。它支持参数默认值，并处理 WordPress 的永久链接结构。

关键要点

  • 函数返回字符串类型的归档链接，基于年、月、日参数生成。
  • 参数 $year、$month、$day 可接受整数或 false（false 时使用当前日期）。
  • 内部使用 WP_Rewrite 处理永久链接结构，若未设置则回退到查询字符串格式。
  • 通过 apply_filters('day_link', ...) 提供钩子，允许开发者过滤链接。
  • 相关函数包括 zeroise()、current_time()、user_trailingslashit() 等。

代码示例

// 获取当前日期的归档链接
$link = get_day_link(false, false, false);

// 获取指定日期（如2023年12月25日）的归档链接
$link = get_day_link(2023, 12, 25);

注意事项

  • 确保参数为有效整数或 false，否则可能导致意外行为。
  • 链接格式取决于 WordPress 的永久链接设置。
  • 函数在循环中常与 get_the_time() 结合使用，以动态生成日期链接。
📄 原文内容

Retrieves the permalink for the day archives with year and month.

Parameters

$yearint|falserequired
Integer of year. False for current year.
$monthint|falserequired
Integer of month. False for current month.
$dayint|falserequired
Integer of day. False for current day.

Return

string The permalink for the specified day, month, and year archive.

Source

function get_day_link( $year, $month, $day ) {
	global $wp_rewrite;
	if ( ! $year ) {
		$year = current_time( 'Y' );
	}
	if ( ! $month ) {
		$month = current_time( 'm' );
	}
	if ( ! $day ) {
		$day = current_time( 'j' );
	}

	$daylink = $wp_rewrite->get_day_permastruct();
	if ( ! empty( $daylink ) ) {
		$daylink = str_replace( '%year%', $year, $daylink );
		$daylink = str_replace( '%monthnum%', zeroise( (int) $month, 2 ), $daylink );
		$daylink = str_replace( '%day%', zeroise( (int) $day, 2 ), $daylink );
		$daylink = home_url( user_trailingslashit( $daylink, 'day' ) );
	} else {
		$daylink = home_url( '?m=' . $year . zeroise( $month, 2 ) . zeroise( $day, 2 ) );
	}

	/**
	 * Filters the day archive permalink.
	 *
	 * @since 1.5.0
	 *
	 * @param string $daylink Permalink for the day archive.
	 * @param int    $year    Year for the archive.
	 * @param int    $month   Month for the archive.
	 * @param int    $day     The day for the archive.
	 */
	return apply_filters( 'day_link', $daylink, $year, $month, $day );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘day_link’, string $daylink, int $year, int $month, int $day )

Filters the day archive permalink.

Uses Description
zeroise()wp-includes/formatting.php

Add leading zeros when necessary.
current_time()wp-includes/functions.php

Retrieves the current time based on specified type.
user_trailingslashit()wp-includes/link-template.php

Retrieves a trailing-slashed string if the site is set for adding trailing slashes.
WP_Rewrite::get_day_permastruct()wp-includes/class-wp-rewrite.php

Retrieves the day permalink structure with month and year.
home_url()wp-includes/link-template.php

Retrieves the URL for the current site where the front end is accessible.
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Show 2 moreShow less

Used by Description
wp_get_archives()wp-includes/general-template.php

Displays archive links based on type and format.
get_calendar()wp-includes/general-template.php

Displays calendar with days that have posts as links.
redirect_canonical()wp-includes/canonical.php

Redirects incoming links to the proper URL based on the site url.

Changelog

Version Description
1.0.0 Introduced.

User Contributed Notes

  1. Skip to note 3 content


    Codex


    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Use With Variables

    PHP code block for use within The Loop: Assigns year, month and day of a post to the variables $arc_year, $arc_month and $arc_day. These are used with the get_day_link() tag, which returns the URL as a link to the daily 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.

    
<a href="<?php echo esc_url( get_day_link( $archive_year, $archive_month, $archive_day ) ); ?>">
	
</a>