php毫秒时间戳存入mysql的datetime(3)字段，核心做法是将13位整数时间戳除以1000转为秒级浮点数后传入，利用mysql自动处理小数秒精度。具体实现时，使用pdo或mysqli绑定参数时直接传递该数值，数据库会自动截断或舍入到最近的毫秒值。若传入的是字符串格式的时间戳，需先转换为数字类型再执行除法运算，避免隐式转换导致的精度丢失或sql语法错误。
如何正确格式化毫秒时间戳为SQL可识别的日期字符串
当不使用参数绑定而采用拼接SQL字符串的方式时，必须将毫秒时间戳转换为标准的 YYYY-MM-DD HH:MM:SS.fff 格式。PHP中可以使用 date() 函数配合 substr() 截取毫秒部分，或者直接使用 DateTime 对象进行格式化。关键点是确保小数点后恰好有三位数字，不足补零，超出则截断，以匹配 DATETIME(3) 的定义。
$timestamp = 1678886400123;
$date = date('Y-m-d H:i:s', $timestamp / 1000);
$ms = substr($timestamp % 1000, 0, 3);
$sql = "INSERT INTO events (created_at) VALUES ('$date.$ms')";
上述代码首先通过整除1000获取秒级时间并格式化为基本日期时间串，然后取余数得到毫秒部分并截取前三位。最终拼接成的字符串如 2023-03-15 12:00:00.123 可直接被MySQL解析。注意如果毫秒部分不足三位（例如 105），无需额外补零，因为 substr 会保持原样，但MySQL通常能容忍这种微小差异，不过为了规范建议统一补零或使用 sprintf('%03d')。
立即学习“PHP免费学习笔记（深入）”；
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
参数绑定模式下如何处理浮点精度与类型转换
在使用PDO或mysqli进行参数绑定时，可以直接传递经过 / 1000 计算后的浮点数。MySQL驱动通常会将浮点数转换为字符串或直接作为数值处理，从而保留小数秒精度。这种方式比字符串拼接更安全，能有效防止SQL注入，同时避免了手动格式化可能带来的格式错误。需要注意的是，某些旧版驱动程序可能对浮点数支持不佳，此时应显式转换为字符串或双精度浮点型。
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
$stmt = $pdo->prepare('INSERT INTO events (created_at) VALUES (?)');
$timestamp = 1678886400123;
$value = $timestamp / 1000;
$stmt->execute([$value]);
在此示例中，$value 是一个浮点数，例如 1678886400.123。PDO默认将其视为字符串或数值传入，MySQL接收后会根据 DATETIME(3) 的定义存储相应精度的时间。若发现精度丢失，可尝试使用 PDO::PARAM_STR 强制以字符串形式绑定，或在PHP端使用 number_format($value, 3, '.', '') 确保格式一致。此方法适用于大多数现代PHP和MySQL组合，无需额外配置即可稳定工作。
不同输入源下毫秒精度是否会被截断或舍入
当传入的毫秒时间戳包含超过三位小数的精度时，MySQL会根据 DATETIME(3) 的定义进行截断而非四舍五入。例如，若传入 1678886400.1239，实际存储值为 2023-03-15 12:00:00.123。这种行为是确定性的，开发者无需担心随机舍入问题。但若传入的是非标准格式或无法解析的值，MySQL会抛出错误或插入 0000-00-00 00:00:00.000，因此输入验证至关重要。
