Question

single_month_title( string $prefix = '',  bool $display = true )

Display or retrieve page title for post archive based on date.

---

description

Useful for when the template only needs to display the month and year, if either are available. The prefix does not automatically place a space between the prefix, so if there should be a space, the parameter value will need to have it at the end.

---

参数

$prefix

(string) (Optional) What to display before the title.

Default value: ''

$display

(bool) (Optional) Whether to display or retrieve title.

Default value: true

---

返回值

(string|void) Title when retrieving.

---

源代码

File: wp-includes/general-template.php

function single_month_title($prefix = '', $display = true ) {
	global $wp_locale;

	$m = get_query_var('m');
	$year = get_query_var('year');
	$monthnum = get_query_var('monthnum');

	if ( !empty($monthnum) && !empty($year) ) {
		$my_year = $year;
		$my_month = $wp_locale->get_month($monthnum);
	} elseif ( !empty($m) ) {
		$my_year = substr($m, 0, 4);
		$my_month = $wp_locale->get_month(substr($m, 4, 2));
	}

	if ( empty($my_month) )
		return false;

	$result = $prefix . $my_month . $prefix . $my_year;

	if ( !$display )
		return $result;
	echo $result;
}

---

更新日志

Version	description
0.71	Introduced.

---

相关函数

Uses

• wp-includes/query.php: get_query_var()
• wp-includes/class-wp-locale.php: WP_Locale::get_month()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Month and Year on New Lines

   Displays the title, placing month and year on new lines.

   
   <p><?php single_month_title('<br />') ?></p>
   

   Output is following 2 lines.

   
   December
   2004