使用 datetimeimmutable 获取毫秒时间,最直接的方法是先通过 format('u') 获取微秒部分,再除以 1000 取整得到毫秒。由于该对象本身不直接提供毫秒格式化占位符,这种字符串处理结合数学运算的方式能确保获得精确的数值结果。

DateTimeImmutable 如何转换为毫秒级时间戳
将 DateTimeImmutable 实例转换为毫秒时间戳,需要调用 getTimestamp() 获取秒级时间戳,并加上由 format('u') 计算出的毫秒偏移量。具体做法是先用 getTimestamp() 拿到整数秒,再用 intval($dt->format('u') / 1000) 算出毫秒数,两者相加即可。

$dt = new DateTimeImmutable();
$seconds = $dt->getTimestamp();
$microseconds = $dt->format('u');
$milliseconds = intval($microseconds / 1000);
$result = ($seconds * 1000) + $milliseconds;
echo $result;
这段代码首先创建一个当前的 DateTimeImmutable 对象。接着提取秒级时间戳和微秒字符串。最后将微秒字符串转为整数并除以 1000,与秒级时间戳乘以 1000 后的值相加,输出最终的毫秒时间戳。
立即学习“PHP免费学习笔记(深入)”;
如何处理时区对毫秒计算的影响
在涉及不同时区的场景下,DateTimeImmutable 的时区设置不会影响毫秒值的内部计算逻辑,但会影响 getTimestamp() 返回的绝对时间值。只要确保对象初始化时指定了正确的时区,上述转换公式依然适用,因为毫秒偏移量始终基于对象内部的纳秒/微秒状态。

$dtCST = new DateTimeImmutable('now', new DateTimeZone('Asia/Shanghai'));
$dtUTC = new DateTimeImmutable('now', new DateTimeZone('UTC'));
function getMs($dt) {
return (intval($dt->getTimestamp()) * 1000) + intval($dt->format('u') / 1000);
}
echo getMs($dtCST) . PHP_EOL;
echo getMs($dtUTC); // 注意:'now' 在不同时区执行瞬间可能不同
这里定义了两个不同时区的 DateTimeImmutable 实例。通过封装函数 getMs 统一处理转换逻辑。虽然时区不同导致 getTimestamp() 基准点不同,但毫秒部分的提取方式完全一致。实际运行中,由于两个对象创建时间极短,结果会非常接近,但严格来说它们代表不同时刻。
format('u') 返回空值或零值时的行为
当 DateTimeImmutable 对象的微秒部分为 0 时,format('u') 仍然返回 '000000' 而不是空字符串。这意味着在进行除法运算时不会报错,而是正确计算出 0 毫秒。这一特性使得该转换方法在处理整秒时间点时依然稳健。
$dtZero = new DateTimeImmutable('2023-01-01 00:00:00.000000');
$us = $dtZero->format('u');
echo $us; // 输出 000000
echo intval($us / 1000); // 输出 0
此示例验证了微秒为零的情况。即使时间点是整秒,format('u') 仍填充六个零。将其转为整数后除以 1000,结果为 0,不影响最终毫秒时间戳的计算。这证明了该方法在各种边界条件下均能保持一致性。



















