PHP 中生成带毫秒的时间戳

今天在对接一个 API 的时候，发现需要生成高精度的时间戳，格式为yyyyMMddHH24mmssSSS。

本文将介绍两种常见的实现方式，并讨论它们的优缺点。

时间格式解析

格式 yyyyMMddHH24mmssSSS 的含义如下：

yyyy：四位数的年份（例如：2025）。
MM：两位数的月份（01-12）。
dd：两位数的日期（01-31）。
HH24：两位数的小时（24 小时制，00-23）。
mm：两位数的分钟（00-59）。
ss：两位数的秒（00-59）。
SSS：三位数的毫秒（000-999）。

例如，时间 2025-01-02 11:30:45.123 的格式化结果为：20250102113045123。

使用 `DateTime` 类实现

以下是使用 DateTime 类生成毫秒时间戳的代码示例：

<?php
$dateTime = new DateTime();
// 获取当前时间的微秒数并计算为毫秒
$milliseconds = intval($dateTime->format('u') / 1000);
// 格式化时间
$formattedTime = $dateTime->format("YmdHi") . $dateTime->format("s") . sprintf("%03d", $milliseconds);
echo $formattedTime;

代码解析

$dateTime->format('u') 返回当前时间的微秒（6 位数，例如 123456）。
intval($dateTime->format('u') / 1000) 将微秒转换为毫秒（3 位数，例如 123）。
使用 sprintf("%03d", $milliseconds) 确保毫秒部分始终为 3 位数（不足时补零）。

示例输出

假设当前时间为 2025-01-02 11:30:45.123456，输出结果为：

20250102113045123

使用 `microtime` 函数实现

另一种方法是结合 microtime() 和 date() 函数：

<?php
$microtime = microtime(true);
// 格式化时间到秒
$formattedDate = date('YmdHis', floor($microtime));
// 获取毫秒部分
$milliseconds = sprintf('%03d', ($microtime - floor($microtime)) * 1000);
// 拼接毫秒
$formattedDate .= $milliseconds;
echo $formattedDate;

代码解析

microtime(true) 返回当前 Unix 时间戳，包含秒和小数部分。
floor($microtime) 获取整数秒部分。
($microtime - floor($microtime)) * 1000 提取小数部分并转换为毫秒。
最终拼接秒部分和毫秒部分，生成完整的时间戳。

示例输出

假设当前时间为 2025-01-02 15:30:45.123456，输出结果为：

20250102153045123

对比分析

特性	使用 `DateTime` 类	使用 `microtime()`
代码简洁性	更加现代化，语义清晰	较为传统，需要手动处理毫秒
精度	取决于系统支持的时间精度	依赖 `microtime()` 的实现
扩展性	更容易与其他 `DateTime` 操作结合	适合处理与 Unix 时间戳相关的逻辑

统一验证输出

为了验证两种方法的输出是否一致，可以添加以下代码：

if ($formattedTime === $formattedDate) {
    echo "两种方法的输出一致：$formattedTime\n";
} else {
    echo "两种方法的输出不一致：\n第一种方法：$formattedTime\n第二种方法：$formattedDate\n";
}