当前浏览:首页 / WordPress函数 / the_date()

the_date( string $format = '', string $before = '', string $after = '', bool $echo = true )

显示或检索当前文章的撰写日期(每个日期一次)

datemore...

themore...


描述

仅当当前文章的日期与前一个输出不同时,才会输出日期。

也就是说,在循环中显示的每一天的文章,只有一个日期列表,即使该函数为每个文章调用了几次。

HTML输出可以用‘the_date’过滤。日期字符串输出可以用‘get_the_date’过滤。


参数

$format

(string)(可选) PHP日期格式。默认为'date_format'选项。

默认值: ''

$before

(string)(可选) 日期之前的输出。

默认值: ''

$after

(string)(可选) 日期后的输出。

默认值: ''

$echo

(bool)(可选) 是回显日期还是返回日期。

默认值: true


返回

(string|void) 如果是检索,则返回字符串。



源码

查看源码 官方文档


更新日志

版本描述
0.71开始引入

使用示例

  • 示例1

    标题中的日期(年、月、日)
    使用“2007-07-23”格式(例如:2004-11-30)在一个<h2>标签

    <?php the_date( 'Y-m-d', '<h2>', '</h2>' ); ?>
    
  • 示例2

    默认用法
    使用默认值显示日期。

    <?php the_date(); ?>
    
  • 示例3

    标题中的日期使用$my_date变量
    以默认格式返回<h2>标签并将其分配给$my_date变量。然后使用PHP echo命令显示变量的值。

    $my_date = the_date( '', '<h2>', '</h2>', false );
    echo $my_date;
    
  • 示例4

    如文档中所述,如果同一天有多个文章,则只会显示一次
    为了显示当天发布的文章的日期,我们应该使用模板标签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日期格式

  • 示例5

    //为循环添加特定日期格式

    //例如格式:November 10, 2021. 你可以看到日期格式字符串的例子:

    <?php the_time( 'F j, Y' );?>