PHP DateInterval.days 为什么有时是 false 而不是天数

如果你从 DateInterval 里直接读取 days，发现结果是 false，通常不是 PHP 计算错了，而是这个对象并不是由两个日期的 diff() 生成的。days 表示“两个日期之间的完整天数”，不是所有间隔对象都能推导出的字段；手工构造的 new DateInterval('P7D') 只有组件天数 d=7，其 days 应当按未知处理。

本文按 PHP 版本迁移的视角，把创建方式、字段含义和改写清单放在一起。需要总天数时，优先让 DateTimeImmutable::diff() 计算间隔；只需要一个固定的七天区间时，则读取 d 或使用 format('%d')。

先确认 days 的真实含义

PHP 手册对 DateInterval::$days 的定义很明确：只有通过 DateTime::diff() 或 DateTimeImmutable::diff() 创建的对象，days 才是起止日期之间的完整天数；其他来源的间隔会得到 false。因此下面的判断应放在“创建间隔”之后，而不是把所有 DateInterval 都当作日期差。

diff($end);

// 结果是 30；d 只表示拆分后的“剩余天”组件，这里是 1。
var_dump($interval->days); // int(30)
var_dump($interval->d);    // int(1)
?>

这个例子正好说明了两个字段的差别：1 个月加 1 天可以换算成 30 个完整天数，但 d 只保留日历分解后的天组件。业务要做逾期、账期或日期范围统计时，使用 days，不要使用 d 代替。

为什么 days 会是 false

DateInterval 也可以表示一个固定周期，而不是两个具体日期的差。例如 P7D 表示七天这个周期，但它没有起点和终点，PHP 无法从它推导出“两个日期相差多少天”，所以 days 为 false。

days); // bool(false)
var_dump($fixed->d);    // int(7)

// 相对字符串同样是构造间隔，不会自动变成日期差。
$relative = DateInterval::createFromDateString('7 days');
var_dump($relative->days); // bool(false)
?>

createFromDateString() 解析的是相对时间字符串，也不代表某个已经确定的起止日期。PHP 8.2 以后，这类对象还会暴露 from_string 和 date_string，可以用来识别来源，但不能因此把 days 当成总天数。

days、d 和 format('%a') 怎么选

可以把三个入口按业务问题区分：

如果要格式化日期差，%a 与属性 days 的来源限制相同；如果要格式化手工周期，使用 %d 更符合语义。不要通过强制转换把 false 变成 0，再把 0 当成“相差零天”。那会把“没有总天数信息”和“确实相差零天”混为一谈。

版本迁移时要关注哪些变化

days 的核心语义没有因为版本升级而变成“所有间隔都可用”，但对象属性和异常行为有迁移影响：

这些变化影响的是调试、类型和错误处理，不会改变“diff 间隔才有总天数”的判断。迁移时先确认业务拿到的是日期差还是周期，再决定读取哪个字段。

迁移检查清单

1. 如果输入是起止日期，统一使用 DateTimeImmutable::diff()，再读取 days。
2. 如果输入只是“七天”“两个月”这类周期，读取 d、m 等组件，不读取 days。
3. 需要展示完整天数时使用 format('%a')，并确认对象确实来自 diff()。
4. 不要把 false 强转成 0；先区分“未知总天数”和“总天数为 0”。
5. 升级到 PHP 8.3 及以上后，为相对日期字符串增加异常处理，并用测试覆盖无效输入。

一句话总结：days 是日期差的总量，d 是间隔拆分后的日组件。看到 false 时，先回到对象的创建路径，而不是继续修改取值代码。

常见问题

new DateInterval('P7D') 为什么不能读取总天数？

因为它只有周期规格，没有起止日期。七天应从 d 或 format('%d') 读取。

diff() 后 days 和 d 不一样是不是错误？

不是。days 是完整日期范围的总天数，d 是按年、月、日拆分后剩余的日组件，二者解决的问题不同。