PHP date()：获取、格式化和计算日期

date('Y-m-d') 以字符串形式返回今天的日期，例如 2026-03-14。第一个参数是格式字符串，其中每个字母代表日期的一部分（Y 是年，m 是月，d 是日，H:i:s 是时间）；可选的第二个参数是一个 Unix 时间戳，传入后就格式化这个时间戳，而不是当前时刻。

<?php
echo date('Y-m-d'), "\n";          // today's date
echo date('H:i:s'), "\n";          // current time, 24-hour clock
echo date('Y-m-d H:i:s'), "\n";    // both, the format databases use
echo date('l, F jS, Y'), "\n";     // long form, e.g. Saturday, March 14th, 2026
echo time(), "\n";                 // seconds since 1970-01-01 00:00:00 UTC

每次点击“运行”，输出都会变化，因为它是 UTC 的当前日期和时间。格式字符串中的每个字母，以及如何在字母之间插入普通文本，都在 PHP 日期格式页面中。

时间戳：time()、mktime() 和 strtotime()

Unix 时间戳是从 UTC 1970年1月1日零点起经过的秒数。time() 返回当前的时间戳，mktime(hour, minute, second, month, day, year) 用各个部分构造一个时间戳，strtotime() 读取用英文写的日期（'2026-03-14'、'+1 week'、'next monday'）。任何时间戳都可以作为 date() 的第二个参数传入。strtotime() 的第二个参数是相对短语的计算起点；不传时，从现在开始算。

<?php
$ts = mktime(9, 30, 0, 3, 14, 2026);   // 2026-03-14 09:30:00
echo $ts, "\n";
echo date('D, d M Y H:i', $ts), "\n";

// mktime() rolls over: month 13 of 2026 is January 2027
echo date('Y-m-d', mktime(0, 0, 0, 13, 1, 2026)), "\n\n";

$phrases = ['tomorrow', '+1 week', 'next monday', 'last day of this month', 'first monday of next month'];
foreach ($phrases as $phrase) {
    echo str_pad($phrase, 28), date('D Y-m-d', strtotime($phrase, $ts)), "\n";
}

var_dump(strtotime('not a date'));   // false: check before you use it

输出：

1773480600
Sat, 14 Mar 2026 09:30
2027-01-01

tomorrow                    Sun 2026-03-15
+1 week                     Sat 2026-03-21
next monday                 Mon 2026-03-16
last day of this month      Tue 2026-03-31
first monday of next month  Mon 2026-04-06
bool(false)

mktime() 的自动进位很有用：某个月的第 0 天就是上个月的最后一天，所以 mktime(0, 0, 0, 3, 0, 2026) 是 2月28日。在把结果传给下一步之前，一定要先和 false 比较：date('Y-m-d', false) 会悄悄输出 1970-01-01，这是谁都不想要的日期。

给日期加上天数

除了输出之外的任何操作，都应该使用 DateTimeImmutable。它的 modify() 方法接受和 strtotime() 相同的短语，并返回一个新的日期；add() 接受一个 DateInterval，例如 P7D（7 天的时间段）或 PT90M（90 分钟）。

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

echo $date->modify('+7 days')->format('Y-m-d'), "\n";
echo $date->modify('-1 day')->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('P1M'))->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('PT90M'))->format('H:i'), "\n";
echo $date->sub(new DateInterval('P1Y'))->format('Y-m-d'), "\n";

// Adding a month to January 31 overflows into March
$jan31 = new DateTimeImmutable('2026-01-31');
echo $jan31->modify('+1 month')->format('Y-m-d'), "\n";
echo $jan31->modify('last day of next month')->format('Y-m-d'), "\n";

输出：

2026-03-21
2026-03-13
2026-04-14
11:00
2025-03-14
2026-03-03
2026-02-28

2月31日并不存在，所以 1月31日加上 +1 month 会落到 3月3日。如果你想要的是“下个月的最后一天”，就明确写成 last day of next month。

DateTime 与 DateTimeImmutable

调用 modify()、add() 或 setDate() 时，DateTime 会修改自身，并返回同一个对象。如果你把原始日期保存在一个变量里，这一点会让你大吃一惊：

<?php
$start = new DateTime('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // the start moved too
echo $end->format('Y-m-d'), "\n";
var_dump($start === $end);            // the same object

$start = new DateTimeImmutable('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // unchanged
echo $end->format('Y-m-d'), "\n";

输出：

2026-03-21
2026-03-21
bool(true)
2026-03-14
2026-03-21

在新代码中优先使用 DateTimeImmutable。两个类的方法相同，也都实现了 DateTimeInterface，所以一个函数可以同时接受两者。

两个日期之间的差值

diff() 返回一个 DateInterval。它的 days 属性是两个日期之间的总天数，而 y、m 和 d 把这段间隔拆分成年、月、日，计算年龄需要的正是这些。修改日期后再运行一次：

<?php
$birthday = new DateTimeImmutable('1990-07-20');
$today = new DateTimeImmutable('2026-03-14');

$age = $birthday->diff($today);
echo "Age: {$age->y}\n";
echo "Exactly: {$age->y} years, {$age->m} months, {$age->d} days\n";
echo "Days alive: {$age->days}\n";

$christmas = new DateTimeImmutable('2026-12-25');
$wait = $today->diff($christmas);
echo $wait->days, " days to go\n";
echo $wait->format('%m months and %d days'), "\n";

// Reversed order: invert is 1 and %R prints the sign
echo $christmas->diff($today)->format('%R%a days'), "\n";

输出：

Age: 35
Exactly: 35 years, 7 months, 22 days
Days alive: 13021
286 days to go
9 months and 11 days
-286 days

在 format() 中，%a 是总天数，而 %d 只是“日”这一部分，所以计算“还有几天”时要用 %a。如果只想比较两个日期而不需要差值，普通的运算符就可以直接用于日期对象：$today < $christmas 是 true。

时区

date() 和 new DateTimeImmutable() 使用默认时区，它来自 php.ini 中的 date.timezone（未设置时为 UTC）。用 date_default_timezone_set() 为整个脚本设置时区，或者给单个日期指定它自己的 DateTimeZone，再用 setTimezone() 转换：

<?php
$meeting = new DateTimeImmutable('2026-03-14 09:30', new DateTimeZone('UTC'));

foreach (['Asia/Tokyo', 'Europe/Berlin', 'America/New_York'] as $zone) {
    $local = $meeting->setTimezone(new DateTimeZone($zone));
    echo str_pad($zone, 18), $local->format('Y-m-d H:i T P'), "\n";
}

date_default_timezone_set('Asia/Tokyo');
echo date_default_timezone_get(), "\n";
echo date('Y-m-d H:i', $meeting->getTimestamp()), "\n";

输出：

Asia/Tokyo        2026-03-14 18:30 JST +09:00
Europe/Berlin     2026-03-14 10:30 CET +01:00
America/New_York  2026-03-14 05:30 EDT -04:00
Asia/Tokyo
2026-03-14 18:30

时间戳在任何地方都是同一个数字，时区只改变它的显示方式。这就是为什么通常建议用 UTC 存储日期，在显示时再转换。

在网页上显示日历

日期最常被输出到 HTML 中。下面的代码把当前月份画成一个日历，并高亮显示今天。运行它，然后点击 Previous 或 Next：同一个脚本会再次运行，并根据链接设置 $_GET['m']，例如 ?m=2026-04。

<?php
$month = $_GET['m'] ?? date('Y-m');
$first = DateTimeImmutable::createFromFormat('!Y-m', $month)
    ?: new DateTimeImmutable('first day of this month midnight');

$prev = $first->modify('-1 month')->format('Y-m');
$next = $first->modify('+1 month')->format('Y-m');
$today = date('Y-m-d');
$days = (int) $first->format('t');   // days in this month
?>
<style>
    th, td { width: 2.4em; padding: 4px; text-align: center; }
    .today { background: #ffd54f; border-radius: 4px; }
</style>
<h3><?= $first->format('F Y') ?></h3>
<p><a href="?m=<?= $prev ?>">Previous</a> | <a href="?m=<?= $next ?>">Next</a></p>
<table>
    <tr><th>Mon</th><th>Tue</th><th>Wed</th><th>Thu</th><th>Fri</th><th>Sat</th><th>Sun</th></tr>
    <tr>
<?php
echo str_repeat('<td></td>', (int) $first->format('N') - 1);
for ($day = 1; $day <= $days; $day++) {
    $date = $first->modify('+' . ($day - 1) . ' days');
    $class = $date->format('Y-m-d') === $today ? ' class="today"' : '';
    echo "<td$class>$day</td>";
    if ($date->format('N') === '7' && $day < $days) {
        echo "</tr>\n<tr>";
    }
}
?>
    </tr>
</table>

format('N') 以 1（星期一）到 7（星期日）给出星期几，这正是 1 号前面需要的空格子数；format('t') 给出该月的天数。'!Y-m' 中的 ! 会重置格式中没有提到的所有字段，所以日期是 1 号，时间是零点。

使用 date() 的常见错误

date() 的第二个参数必须是时间戳，而不是日期字符串。下面这行代码：

<?php
echo date('d/m/Y', '2026-03-14');

会让脚本因 TypeError 而停止：

PHP Fatal error:  Uncaught TypeError: date(): Argument #2 ($timestamp) must be of type ?int, string given in /home/index.php:2

先转换字符串，可以用 strtotime()，也可以用对象：

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

echo date('d/m/Y', strtotime($input)), "\n";
echo (new DateTimeImmutable($input))->format('d/m/Y'), "\n";

// Check that a date really exists before using it
var_dump(checkdate(2, 29, 2026));   // 2026 is not a leap year
var_dump(checkdate(2, 29, 2028));

输出：

14/03/2026
14/03/2026
bool(false)
bool(true)

还有两个需要注意的地方：m 是月份，i 是分钟，所以 'H:m' 会在你想显示分钟的位置输出月份；new DateTimeImmutable('garbage') 会抛出异常，而不是返回 false，所以要把用户输入放在 try/catch 中，或者用 DateTimeImmutable::createFromFormat() 解析，它在不匹配时会返回 false。