为何MySQL中DATETIME(6)的最大微秒值为.499999而非.999999？

我需要定义一个非NULL的datetime缺失标记值，查MySQL文档得知DATETIME(6)的范围是'1000-01-01 00:00:00.000000'至'9999-12-31 23:59:59.499999'，但实际测试中发现.999999的微秒值也能被插入，想知道为什么官方文档标注的最大微秒值是.499999而非更直观的.999999？

测试代码如下：

mysql> create temporary table _test (dt datetime(6));
Query OK, 0 rows affected (0.01 sec)

mysql> insert into _test
     > values ('9999-12-31 23:59:59.499999'), ('9999-12-31 23:59:59.999998'), ('9999-12-31 23:59:59.999999');
Query OK, 3 rows affected (0.00 sec)
Records: 3  Duplicates: 0  Warnings: 0

mysql> select all dt as i, dt + interval 1 microsecond as f from _test;
+----------------------------+----------------------------+
| i                          | f                          |
+----------------------------+----------------------------+
| 9999-12-31 23:59:59.499999 | 9999-12-31 23:59:59.500000 |
| 9999-12-31 23:59:59.999998 | 9999-12-31 23:59:59.999999 |
| 9999-12-31 23:59:59.999999 | NULL                       |
+----------------------------+----------------------------+
3 rows in set, 1 warning (0.00 sec)

问题解答 #

1. 文档标注与实际插入的差异原因 #

MySQL文档里标注的'9999-12-31 23:59:59.499999'是安全上限值——这个时间点加1微秒不会溢出到无效日期（加完后是'9999-12-31 23:59:59.500000'，仍在合法范围内）。而'9999-12-31 23:59:59.999999'是物理存储的极限值，虽然能插入，但对它执行加1微秒操作就会溢出（超出9999-12-31这个最大日期），返回NULL并触发警告。

MySQL允许插入极限值是因为存储结构支持，但文档推荐使用安全上限，避免后续日期运算出现异常。

2. 非NULL缺失标记值的推荐方案 #

如果要定义非NULL的datetime缺失标记，优先推荐使用文档标注的安全上限值'9999-12-31 23:59:59.499999'，原因：

• 不会和正常业务时间冲突（正常业务时间不可能接近这个极限）
• 后续对这个值进行日期运算（比如加减时间）不会直接溢出返回NULL，稳定性更高
• 符合官方文档的规范，避免潜在的版本兼容性问题

如果一定要用极限值'9999-12-31 23:59:59.999999'，需要注意：所有对该值的日期运算都要做溢出判断，否则会得到NULL结果。

内容的提问来源于stack exchange，提问作者JCH77