PHP DateTimeImmutable createFromInterface 怎么保留时区

DateTimeImmutable::createFromInterface() 会直接复制传入对象的日期、时间和时区信息，返回一个新的 DateTimeImmutable；原来的 DateTime 或 DateTimeImmutable 不会被修改。因此，要“保留原时区地转成不可变对象”，不需要先格式化为字符串，也不需要手动取时间戳再重建。

先明确转换的目标和边界

很多领域服务希望只保存不可变日期，调用方却可能传入可变的 DateTime。如果直接保存接口对象，后续代码还可能修改它；如果用字符串重建，又容易遗漏微秒、时区名称或格式边界。createFromInterface 正好承担“保留信息，切断可变引用”的转换职责。

该方法属于 PHP 8，签名接收 DateTimeInterface，返回新的 DateTimeImmutable。PHP 手册明确说明：来源对象不修改，新对象包含相同的日期、时间和时区信息。

最小写法会自动保留原时区

下面的来源时间使用 Asia/Shanghai。转换时没有额外传入 DateTimeZone，因为时区已经包含在来源对象中。

format('Y-m-d H:i:s.u P e');

这里的关键不是格式化结果，而是对象语义：$immutable 是新对象。随后修改 $source 不会影响副本；对不可变副本调用修改方法也会返回另一个新对象。

用三组信息核对是否真的保留

只比较 Y-m-d H:i:s 不够，因为两个对象可能显示相同墙上时间，却拥有不同的时区或微秒。稳妥的检查可以分成三组：

getTimestamp() === $right->getTimestamp()
        && $left->format('u') === $right->format('u');

    // 时区名称比单独比较当前偏移更能表达原时区身份。
    $sameZone = $left->getTimezone()->getName()
        === $right->getTimezone()->getName();

    return $sameInstant && $sameZone;
}

$copy = DateTimeImmutable::createFromInterface($source);
var_dump(sameDateTimeState($source, $copy));

保留时区与转换时区不是一回事

createFromInterface 的职责是复制，不会把日期自动改成服务器默认时区，也不会统一成 UTC。如果业务规范要求数据库、消息或日志统一使用 UTC，应在创建不可变副本之后显式调用 setTimezone。

对 DateTimeImmutable 调用 setTimezone 会返回新对象，并保持同一个时间点，只改变该时间点在目标时区中的显示方式。这样“输入归一化”和“业务时区选择”两个决策保持分离。

setTimezone(new DateTimeZone('UTC'));
}

把统一入口封装在领域边界

如果控制器、DTO 和领域服务都各自判断 DateTime 或 DateTimeImmutable，规则很容易分散。更简单的流程是：边界方法统一接收 DateTimeInterface，立即调用 createFromInterface，内部只传播不可变对象。

startsAt = DateTimeImmutable::createFromInterface($startsAt);
        $this->endsAt = DateTimeImmutable::createFromInterface($endsAt);

        // 比较使用时间点语义，不需要先改成同一显示时区。
        if ($this->endsAt startsAt) {
            throw new InvalidArgumentException('结束时间必须晚于开始时间');
        }
    }
}

这样无论调用方传入可变还是不可变对象，领域对象内部都具有一致的不可变语义，同时保留每个输入的原始时区信息。

常见误区与快速选择

用时间戳重建对象时，新对象通常会按你后续指定或默认的时区显示；用字符串重解析则依赖格式和解析规则。它们都比 createFromInterface 更容易丢失“来源时区”这层信息。

相关问题

传入 DateTimeImmutable 还会创建新对象吗？

会。官方契约返回新的 DateTimeImmutable 实例，因此可把该方法当成统一的不可变复制入口。

createFromInterface 会读取 date_default_timezone_set 吗？

它复制来源对象已有的日期、时间和时区信息，不需要用默认时区替换来源时区。默认时区主要影响没有显式时区的新解析或新建操作。

为什么只比较 UTC 偏移还不够？

多个时区在某个日期可能具有相同偏移，但时区规则和名称不同。要验证“原时区保留”，应比较 getTimezone()->getName()。

DateTimeInterface 能由业务类自己实现吗？

不能。PHP 官方说明该接口用于让类型声明同时接受内置的 DateTime 与 DateTimeImmutable，用户态类不能自行实现它。