WordPress 日期时间格式字符详解
在 WordPress 开发中，我们经常需要使用 date_i18n() 函数或 get_the_date() 等函数来格式化日期和时间。这些函数使用特定的格式字符来控制输出。下表详细解释了这些格式字符的含义和示例。
| 字符 | 说明 | 返回值示例 |
|---|---|---|
| 日 | ||
d |
月份中的第几天，有前导零的 2 位数字 | 01 到 31 |
D |
星期中的第几天，文本表示，3 个字母 | Mon 到 Sun |
j |
月份中的第几天，没有前导零 | 1 到 31 |
l（小写字母 L） |
星期几，完整的文本格式 | Sunday 到 Saturday |
N |
ISO-8601 格式数字表示的星期中的第几天 | 1（星期一）到 7（星期日） |
S |
每月天数后面的英文序数后缀，2 个字符 | st, nd, rd, th。常与 j 一起使用 |
w |
星期中的第几天，数字表示 | 0（星期日）到 6（星期六） |
z |
年份中的第几天 | 0 到 365 |
| 星期 | ||
W |
ISO-8601 格式年份中的第几周，每周从星期一开始 | 例如：42（当年的第 42 周） |
| 月 | ||
F |
月份，完整的文本格式 | January 到 December |
m |
数字表示的月份，有前导零 | 01 到 12 |
M |
三个字母缩写表示的月份 | Jan 到 Dec |
n |
数字表示的月份，没有前导零 | 1 到 12 |
t |
给定月份所应有的天数 | 28 到 31 |
| 年 | ||
L |
是否为闰年 | 闰年为 1，否则为 0 |
o |
ISO-8601 格式年份数字。与 Y 基本相同，但会根据 ISO 周数（W）调整年份 |
例如：1999 或 2003 |
Y |
4 位数字完整表示的年份 | 例如：1999 或 2023 |
y |
2 位数字表示的年份 | 例如：99 或 23 |
| 时间 | ||
a |
小写的上午和下午值 | am 或 pm |
A |
大写的上午和下午值 | AM 或 PM |
B |
Swatch Internet Time（网络标准时） | 000 到 999 |
g |
小时，12 小时格式，没有前导零 | 1 到 12 |
G |
小时，24 小时格式，没有前导零 | 0 到 23 |
h |
小时，12 小时格式，有前导零 | 01 到 12 |
H |
小时，24 小时格式，有前导零 | 00 到 23 |
i |
有前导零的分钟数 | 00 到 59 |
s |
秒数，有前导零 | 00 到 59 |
| 时区 | ||
e |
时区标识符 | 例如：UTC, GMT, Asia/Shanghai |
I |
是否为夏令时 | 夏令时为 1，否则为 0 |
O |
与格林威治时间（GMT）相差的小时数（无冒号） | 例如：+0800 |
P |
与格林威治时间（GMT）的差别，小时和分钟之间有冒号分隔 | 例如：+08:00 |
T |
本机所在的时区缩写 | 例如：CST（中国标准时间）, EST |
Z |
时差偏移量的秒数（UTC 西负东正） | -43200 到 43200 |
| 完整的日期／时间 | ||
c |
ISO 8601 格式的日期 | 例如：2023-10-27T14:30:00+08:00 |
r |
RFC 2822 / 822 格式的日期 | 例如：Fri, 27 Oct 2023 14:30:00 +0800 |
U |
从 Unix 纪元（1970-01-01 00:00:00 GMT）开始至今的秒数 | 与 time() 函数返回值相同 |
使用示例
在 WordPress 主题或插件中，你可以这样使用格式字符：
<?php
// 输出格式如 "2023年10月27日 星期五"
echo date_i18n( 'Y年n月j日 l' );
// 在文章循环中输出格式如 "2023-10-27 14:30"
echo get_the_date( 'Y-m-d H:i' );
?>掌握这些格式字符，可以让你在 WordPress 中灵活地控制日期和时间的显示格式，以满足不同的设计和功能需求。