PHP DateTime::add怎么用-php教程-PHP中文网

datetime::add() 必须传入 dateinterval 对象，不能直接传字符串或数字；它就地修改原对象，不返回新实例；日期溢出会自动归整，时区切换需谨慎处理。

php datetime::add怎么用

DateTime::add 传入的必须是 DateInterval 对象

直接传字符串或数字会报错，比如 DateTime::add('P1D') 或 DateTime::add(86400) 都不行 —— PHP 会抛出 TypeError: DateTime::add(): Argument #1 ($interval) must be of type DateInterval。

正确做法是先用 DateInterval 构造器创建间隔对象，再传进去：

$dt = new DateTime('2024-01-01');
$dt->add(new DateInterval('P1D')); // 加 1 天
echo $dt->format('Y-m-d'); // 2024-01-02

注意：DateInterval 的构造参数是 ISO 8601 格式字符串，常见写法有：

P1Y：1 年（不是 365 天，闰年会自动处理）
P1M：1 月（按日历月推进，比如 1 月 31 日 + 1 月 = 2 月 28/29 日）
P1D：1 天
PT1H：1 小时
PT30M：30 分钟
P2Y3M4DT5H6M7S：复合间隔（2 年 3 月 4 天 5 小时 6 分 7 秒）

DateTime::add 修改原对象，不返回新实例

它和 DateTime::modify() 一样是「就地修改」，不会像 DateTimeImmutable 那样返回副本。所以 $new = $dt->add(...) 得到的还是原 $dt 的引用，$new 和 $dt 指向同一个对象。

如果需要保留原始时间，得手动克隆：

$dt = new DateTime('2024-01-01');
$dt2 = clone $dt;
$dt2->add(new DateInterval('P1D'));

或者直接用 DateTimeImmutable（推荐用于函数式场景）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$dt = new DateTimeImmutable('2024-01-01');
$dt2 = $dt->add(new DateInterval('P1D')); // 返回新对象，$dt 不变

加月份/年份时要注意日溢出问题

比如 2024-01-31->add(P1M) 不会变成 2024-02-31（不存在），而是自动归整为 2024-02-29（因为 2 月只有 29 天）。这是 PHP 的默认行为，不是 bug。

但如果你希望「失败即失败」而不是静默归整，得自己判断：

先加，再用 format('t') 拿当月天数，对比原始日是否超出
或改用 DateTime::modify('+1 month')，它的行为略有不同（更偏向「下个月同日」逻辑，但仍有归整）
复杂业务建议用 Carbon 的 addMonthsNoOverflow() 等辅助方法

DateTime::add 在时区切换后可能表现异常

如果 DateTime 实例绑定了时区（如 new DateTime('2024-01-01', new DateTimeZone('Asia/Shanghai'))），而你在调用 add() 前又用 setTimezone() 切换了时区，后续加减仍基于本地时间计算，但显示会受新时区影响 —— 容易误以为结果不准。

稳妥做法是：