get_the_date() 是 WordPress 中用于获取文章发布日期的模板标签函数,不会直接输出,而是返回日期字符串,便于在 PHP 中进一步处理或赋值给变量。
核心特点
- 返回值:返回格式化后的日期字符串(默认使用 WordPress 后台设置的“日期格式”)。
- 不自动输出:与
the_date()不同,get_the_date()不会直接echo内容,需配合echo使用。 - 支持自定义格式:可通过参数
$d指定 PHP 风格的日期格式。 - 适用于多篇文章同日场景:在同一天发布多篇文章时,不会像
the_date()那样只显示第一篇的日期,每篇文章都能正确显示其日期 28。
基本用法
// 默认格式(使用后台设置的日期格式)
echo get_the_date();
// 自定义格式,例如:2026年04月06日
echo get_the_date('Y年m月d日');
// 指定特定文章(通过ID或对象)
$post = get_post(123);
echo get_the_date('F j, Y', $post);
常见格式示例
| 格式字符串 | 输出示例 | 说明 |
|---|---|---|
'Y-m-d' |
2026-04-06 |
标准日期格式 |
'F j, Y' |
April 6, 2026 |
英文完整月份 |
'Y年n月j日' |
2026年04月06日 |
中文格式(需确保编码支持) |
'M j, Y' |
Apr 6, 2026 |
缩写月份 |
PHP 日期格式字符参考:WordPress 官方文档 – Date Formatting 6
与 the_date() 的区别
| 函数 | 是否输出 | 同日多篇显示 | 返回值 |
|---|---|---|---|
the_date() |
✅ 是 | ❌ 只显示第一篇 | 无(直接输出) |
get_the_date() |
❌ 否(需 echo) |
✅ 每篇都显示 | ✅ 字符串 |
推荐在主题开发中优先使用
get_the_date(),尤其在循环或复杂布局中 28。
实际应用场景
- 在文章列表中为每篇文章单独显示发布日期。
- 将日期赋值给变量用于条件判断或计算。
- 在自定义小工具或区块中动态生成日期内容。
示例:
$pub_date = get_the_date('Y-m-d');
echo "<time datetime='$pub_date'>" . get_the_date('F j, Y') . "</time>";
更多细节可查阅官方文档:get_the_date() – WordPress Developer Resources
