php 的 datetime 对象本身不保留“创建时是否显式指定时间”的元信息，因此无法直接判断一个对象是纯日期还是带时间的日期时间；但可通过扩展属性或格式化比对等策略实现逻辑区分。
php 的 datetime 对象本身不保留“创建时是否显式指定时间”的元信息，因此无法直接判断一个对象是纯日期还是带时间的日期时间；但可通过扩展属性或格式化比对等策略实现逻辑区分。
在 PHP 中，DateTime 对象本质上只存储时间戳（微秒级精度）和时区信息，不记录原始字符串输入格式。这意味着：
$date = new DateTime('2022-09-01'); // 无时间部分
$datetime = new DateTime('2022-09-01 00:00:00'); // 显式含时间
var_dump($date == $datetime); // true —— 它们表示同一时刻二者底层时间戳完全一致（均解析为当天 00:00:00），因此 == 和 === 均返回 true，原生 API 也确实不存在如 $dt->containsTime() 这样的方法。
✅ 可行的区分方案
方案一：运行时标记（推荐，轻量可控）
在创建对象时主动附加类型标识，利用 PHP 对象的动态属性特性：
$date = new DateTime('2022-09-01');
$date->sourceType = 'date'; // 自定义元数据
$datetime = new DateTime('2022-09-01 14:30:45');
$datetime->sourceType = 'datetime';
// 后续可安全判断
if ($date->sourceType === 'date') {
echo "这是一个仅含日期的对象";
}⚠️ 注意：该属性仅用于业务逻辑标识，不影响 DateTime 行为；序列化时需额外处理（如配合 __sleep()）。
立即学习“PHP免费学习笔记（深入）”；
方案二：格式反推（适用于已存在对象且原始字符串不可控）
若无法修改创建逻辑，可尝试用 format() 输出并匹配常见纯日期格式：
function hasExplicitTime(DateTime $dt): bool {
// 检查是否能被标准日期格式完整表示（不含时间）
$asDate = $dt->format('Y-m-d');
$asDateTime = $dt->format('Y-m-d H:i:s');
// 若原始时间恰好是 00:00:00，仍可能误判为 date —— 此法有局限性
return $dt->format('H:i:s') !== '00:00:00'
|| strpos((string)$dt, ':') !== false; // 粗略启发式：toString 含冒号？
}⚠️ 此方案不可靠：new DateTime('2022-09-01 00:00:00') 和 new DateTime('2022-09-01') 的 __toString() 均输出 2022-09-01 00:00:00，无法真正溯源。
✅ 结论与最佳实践
- DateTime 对象在语义上不区分“纯日期”与“日期时间”——它始终是一个时间点。
- 若业务需强制区分（如表单校验、API 输入约束），应在构造阶段显式携带上下文信息（如 $dt->isTimeless = true 或使用 DTO 封装）。
- 避免依赖格式解析做逆向推断，因其易受时区、默认时间补全（如 00:00:00）等影响。
- 更健壮的设计：用值对象（Value Object）封装日期/日期时间语义，例如 DateOnly 和 DateTimePoint 类，从类型层面杜绝歧义。
