描述
仅当当前文章的日期与前一个输出不同时,才会输出日期。
也就是说,在循环中显示的每一天的文章,只有一个日期列表,即使该函数为每个文章调用了几次。
HTML输出可以用‘the_date’过滤。日期字符串输出可以用‘get_the_date’过滤。
参数
- $format
-
(string)(可选) PHP日期格式。默认为'date_format'选项。
默认值: ''
- $before
-
(string)(可选) 日期之前的输出。
默认值: ''
- $after
-
(string)(可选) 日期后的输出。
默认值: ''
- $echo
-
(bool)(可选) 是回显日期还是返回日期。
默认值: true
返回
(string|void) 如果是检索,则返回字符串。
源码
更新日志
版本 | 描述 |
---|---|
0.71 | 开始引入 |
使用示例
标题中的日期(年、月、日)
使用“2007-07-23”格式(例如:2004-11-30)在一个<h2>标签<?php the_date( 'Y-m-d', '<h2>', '</h2>' ); ?>
默认用法
使用默认值显示日期。<?php the_date(); ?>
标题中的日期使用$my_date变量
以默认格式返回<h2>标签并将其分配给$my_date
变量。然后使用PHP echo命令显示变量的值。$my_date = the_date( '', '<h2>', '</h2>', false ); echo $my_date;
如文档中所述,如果同一天有多个文章,则只会显示一次
为了显示当天发布的文章的日期,我们应该使用模板标签the_time()或get_the_date()以及日期特定的格式字符串。<?php echo get_the_date(); ?> // get_the_date() return the date doesn't echo the date, so have to echo to show it // or use the_time() with date-specific format <?php the_time( 'd F Y' ); ?>
这两个函数都采用一个可选参数,该参数遵循PHP日期格式
//为循环添加特定日期格式
//例如格式:November 10, 2021. 你可以看到日期格式字符串的例子:
<?php the_time( 'F j, Y' );?>