NOTES / UNIX TIME

时间戳笔记

这里不重复工具说明书,而是记录那些在联调、日志排查和跨时区协作里真正容易出错的地方。每篇都围绕一个具体问题展开,读完后可以回到转换器亲手验证。

01 / UNIT约 6 分钟

10 位还是 13 位?时间戳单位判断与换算笔记

从数量级、字段命名、数据库类型和前端显示四个角度判断单位,避免 1000 倍误差把日期送到 1970 或 5000 年。

阅读笔记
02 / TIME ZONE约 7 分钟

时间戳差了 8 小时:先查时区,不要先改代码

一条从接口到数据库、再到前端显示的排查链路,解释“时间戳没变,为什么页面上的时间变了”。

阅读笔记
03 / BOUNDARY约 6 分钟

2038 年问题:32 位时间戳的边界与迁移思路

2,147,483,647 这个数字从哪里来,哪些系统可能受影响,以及如何用测试数据和字段检查提前发现风险。

阅读笔记
04 / ENGINEERING约 8 分钟

接口时间字段排查清单:从联调到上线

单位、时区、序列化、数据库精度、前端展示和监控告警,六个环节逐项核对,适合直接放进团队检查表。

阅读笔记

HOW TO READ / 阅读方式

带着一个具体时间来看

时间戳的讨论很容易抽象。更有效的方式是拿一个真实的值:接口返回的、日志里的、数据库里的,或者你正在排查的那一个。先把它放到转换器里,确认 UTC 与本地时间的差异,再回来看文章里的判断顺序。

如果问题涉及具体业务,优先记录原始值、单位、时区和系统版本。四件事写清楚,大多数“时间不对”都能在几分钟内缩小范围。

START FROM A NUMBER

把一个时间戳放进来

先看清楚它在 UTC、北京时间和本地时间里的样子,再去判断单位或时区问题。真实数据往往比抽象讨论更快暴露线索。