描述
当模板仅需要显示月份和年份(如果其中一个可用)时非常有用。前缀不会自动在前缀之间放置空格,因此如果应该有空格,则参数值需要将其放在末尾。
参数
- $prefix
-
(string) (可选) 标题前面显示的内容。
默认值: ''
- $display
-
(bool) (可选) 是显示还是检索标题。
默认值: true
返回
(string|false|void) 如果该月份没有有效标题,则为False。当检索时,返回标题。
说明
- 这个函数只有在WordPress向当前页面传递了
m
或 archive month 参数时才起作用(这发生在查看月份存档页时)。 - 这个函数只适用于日期存档页,而不是类别模板或其他。
- 它不支持将分隔符放在标题之后,但通过将前缀参数留空,你可以手动设置标题分隔符。
源码
更新日志
版本 | 描述 |
---|---|
0.71 | 开始引入 |
使用示例
新行的月份和年份
显示标题,在新行上放置月份和年份。
<p><?php single_month_title('<br />') ?></p>
输出如下2行。
December 2004