PHP 日期格式：date() 的所有格式字符

PHP 日期格式是一个字符串，其中的字母代表日期的各个部分：date('Y-m-d H:i:s') 会输出类似 2026-03-14 09:05:07 的结果。Y 是 4 位数的年份，m 是月，d 是日，H 是小时（24 小时制），i 是分钟，s 是秒；不是格式字母的字符，比如 -、/ 或 :，都会原样输出。同样的格式字符串既可以用在 date() 中，也可以用在 DateTimeImmutable::format() 中。

修改 $format，然后点击“运行”。日期固定为 2026年3月14日星期六 09:05:07，这样你就能清楚地看到每个字母的作用：

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

$format = 'D, d M Y H:i';   // edit me

echo $date->format($format), "\n";
echo $date->format('Y-m-d'), "\n";
echo $date->format('d/m/Y'), "\n";
echo $date->format('l, F jS, Y'), "\n";
echo $date->format('g:i A'), "\n";

输出：

Sat, 14 Mar 2026 09:05
2026-03-14
14/03/2026
Saturday, March 14th, 2026
9:05 AM

date($format) 格式化当前时刻，date($format, $timestamp) 格式化一个时间戳；$date->format($format) 格式化一个日期对象。关于日期的其他内容，从 strtotime() 到时区，都在 PHP date() 页面中。

日期格式字符

下面每个示例都是 2026-03-14 09:05:07.123456 UTC 的结果。

日

周和月

年

时间

时区

完整的日期和时间

下面是可以实时运行的同一张表：这段代码会为你选定的日期输出每一个字符的结果。试试填入你的生日、某个下午的时间，或者闰年的最后一天：

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07.123456');   // try '2028-12-31 18:45'

foreach (str_split('djDlNwSzWFMmntYyLoXxHGhgisaAvuBeTPpOZIcrU') as $char) {
    echo $char, '  ', $date->format($char), "\n";
}

在格式中输出字母和单词

格式字符串中的任何字母都会被当作格式字符，所以 'Today is l' 不会输出“Today is”：T、o、d、a、y、i 和 s 都是格式字符。在每个想原样输出的字母前面加一个反斜杠。在双引号字符串中，\t 本身就是制表符，所以带反斜杠的格式要用单引号：

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format('Today is l'), "\n";            // letters read as format characters
echo $date->format('\T\o\d\a\y \i\s l'), "\n";     // escaped
echo $date->format('l \t\h\e jS \o\f F'), "\n";
echo $date->format('Y-m-d\TH:i:s'), "\n";          // a literal T between date and time

echo $date->format("l \the jS"), "\n";             // double quotes: \t is a tab, h and e are format letters

输出：

UTC202614am26 0507 Saturday
Today is Saturday
Saturday the 14th of March
2026-03-14T09:05:07
Saturday 	09UTC 14th

常用的日期格式

大多数代码只需要少数几种格式。下面这段代码会把它们输出为一个 HTML 表格，所以会显示在“页面”标签页中：

<?php
$date = new DateTimeImmutable('2026-03-14 15:45:00');

$formats = [
    'Y-m-d'       => 'ISO date, sorts correctly as text',
    'Y-m-d H:i:s' => 'MySQL DATETIME',
    'm/d/Y'       => 'United States',
    'd/m/Y'       => 'UK, Europe, most of the world',
    'd.m.Y'       => 'Germany, Russia',
    'F j, Y'      => 'Long US style',
    'j F Y'       => 'Long UK style',
    'D, M j'      => 'Short, for lists',
    'g:i a'       => '12-hour clock',
    'H:i'         => '24-hour clock',
];
?>
<table border="1" cellpadding="6" style="border-collapse: collapse">
    <tr><th>Format</th><th>Result</th><th>Used for</th></tr>
<?php foreach ($formats as $format => $use): ?>
    <tr>
        <td><code><?= $format ?></code></td>
        <td><?= $date->format($format) ?></td>
        <td><?= $use ?></td>
    </tr>
<?php endforeach; ?>
</table>

存储和比较日期时，请使用 Y-m-d 或 Y-m-d H:i:s：按这种顺序排列的字符串，排序结果和日期本身的顺序一致，而 d/m/Y 格式的字符串做不到。

ISO 8601、DATE_ATOM 和其他标准格式

PHP 为 API、订阅源和 cookie 需要的格式提供了常量。DATE_ATOM（也可以写成 DateTimeInterface::ATOM）就是 ISO 8601 和 RFC 3339 格式，JSON API 使用的正是它：

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format(DATE_ATOM), "\n";               // ISO 8601
echo $date->format('c'), "\n";                     // the same, as a character
echo $date->format(DATE_RFC3339_EXTENDED), "\n";   // with milliseconds
echo $date->format(DATE_RFC2822), "\n";            // email headers
echo $date->format(DATE_RSS), "\n";                // RSS feeds
echo $date->format(DATE_COOKIE), "\n";             // cookies

echo DATE_ATOM, "\n";                              // the format string behind it

输出：

2026-03-14T09:05:07+00:00
2026-03-14T09:05:07+00:00
2026-03-14T09:05:07.000+00:00
Sat, 14 Mar 2026 09:05:07 +0000
Sat, 14 Mar 2026 09:05:07 +0000
Saturday, 14-Mar-2026 09:05:07 UTC
Y-m-d\TH:i:sP

还有一个 DATE_ISO8601 常量，但它的偏移没有冒号（+0000），ISO 8601 不允许这种写法；请使用 DATE_ATOM。

日文日期格式（Y年m月d日）

不是格式字母的字符会原样输出，汉字也一样，所以 'Y年n月j日' 可以直接这样写，中文日期同样适用。n 和 j 会去掉前导零（3月14日），m 和 d 会保留前导零（03月14日）。星期几是 date() 唯一无法翻译的部分，因为它只认识英文名称；可以把 w 得到的数字映射到你自己的列表：

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');
$weekdays = ['日', '月', '火', '水', '木', '金', '土'];   // w: 0 = Sunday

echo $date->format('Y年n月j日'), "\n";
echo $date->format('Y年m月d日 H時i分'), "\n";
echo $date->format('Y年n月j日'), '(', $weekdays[$date->format('w')], ")\n";
echo $date->format('Y/m/d'), "\n";

输出：

2026年3月14日
2026年03月14日 09時05分
2026年3月14日(土)
2026/03/14

如果要完整的本地化，包括其他语言的月份名称和日本年号（令和），可以使用 intl 扩展的 IntlDateFormatter，它按语言区域的模式进行格式化。它使用的是 ICU 模式字母（yyyy、MM、EEEE），而不是本页介绍的 PHP 格式字符：

<?php
$formatter = new IntlDateFormatter('ja_JP', IntlDateFormatter::FULL, IntlDateFormatter::NONE, 'Asia/Tokyo');
echo $formatter->format(new DateTimeImmutable('2026-03-14')); // 2026年3月14日土曜日

$era = new IntlDateFormatter('ja_JP@calendar=japanese', IntlDateFormatter::LONG, IntlDateFormatter::NONE, 'Asia/Tokyo', IntlDateFormatter::TRADITIONAL);
echo $era->format(new DateTimeImmutable('2026-03-14'));       // 令和8年3月14日

把日期从一种格式转换成另一种

要把 14/03/2026 转换成 2026-03-14，先用 DateTimeImmutable::createFromFormat() 按字符串原本的格式解析它，再重新格式化。它使用的字符和上面的表格相同。格式要以 ! 开头，否则你没有提供的字段（这里是时间）会用当前时刻填充：

<?php
$input = '14/03/2026';

$date = DateTimeImmutable::createFromFormat('!d/m/Y', $input);
if ($date === false) {
    exit("Not a d/m/Y date\n");
}
echo $date->format('Y-m-d H:i:s'), "\n";
echo $date->format('F j, Y'), "\n";

// The string must match the format, or you get false
var_dump(DateTimeImmutable::createFromFormat('!d/m/Y', '2026-03-14'));

// A date that does not exist overflows, and getLastErrors() says so
$feb31 = DateTimeImmutable::createFromFormat('!d/m/Y', '31/02/2026');
echo $feb31->format('Y-m-d'), "\n";
print_r(DateTimeImmutable::getLastErrors()['warnings']);

输出：

2026-03-14 00:00:00
March 14, 2026
bool(false)
2026-03-03
Array
(
    [10] => The parsed date was invalid
)

对于用户输入的日期，getLastErrors() 返回的任何警告都应该当作无效日期处理，就像处理 false 一样。

日期格式的常见错误

有三个 bug 反复出现：本该写 i 的地方写成了 m，Y 和 y 混用，以及让 strtotime() 去猜日和月的顺序。strtotime() 把斜杠解读为美式的“月/日”顺序，把短横线或点解读为“日-月”顺序，所以同样的数字会得出两个不同的日期：

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format('H:m:s'), "\n";   // wrong: m is the month
echo $date->format('H:i:s'), "\n";   // right: i is the minutes
echo $date->format('d/m/y'), "\n";   // y: 2-digit year

echo date('Y-m-d', strtotime('03/04/2026')), "\n";   // m/d/Y: March 4
echo date('Y-m-d', strtotime('03-04-2026')), "\n";   // d-m-Y: April 3
var_dump(strtotime('14/03/2026'));                   // no month 14: false

输出：

09:03:07
09:05:07
14/03/26
2026-03-04
2026-04-03
bool(false)

如果你知道输入的格式，就用 createFromFormat() 明确指定，而不要让 strtotime() 去猜。