用dayjs解析时间戳，我被提了bug

引言

前几天开发中突然接到测试提的一个 Bug，说我的时间组件显示异常。

我很诧异，这里初始化数据是后端返回的，我什么也没改，这bug提给我干啥。我去问后端：“这数据是不是有问题？”。后端答：“没问题啊，我们一直都是这么返回的时间戳，其他人用也没报错。”

于是，对比生产环境数据，我终于找到了问题根源：后端时间戳的类型，从 Number 静悄悄地变成了 String。

Bug原因

问题的原因，肯定就出现在时间数据解析上了，代码中，我统一用的dayjs做的时间解析。

如图，对时间戳的解析我都是这么写的

const time = dayjs(res.endTime).format('YYYY-MM-DD HH:mm:ss')

于是，我分别试了两种数据类型的解析方式:

• 字符型

dayjs('175008959900').format('YYYY-MM-DD hh:mm:ss') // 1975-07-19 01:35:59

• 数值型

dayjs(Number('175008959900')).format('YYYY-MM-DD HH:mm:ss') // 2025-07-17 06:59:59

看来，问题原因显而易见了：

由于后端返回的是字符串类型 的 '175008959900'，dayjs() 在处理字符串时，会尝试按“常见的日期字符串格式”进行解析（如 YYYY-MM-DD、YYYYMMDD 等），并不会自动识别为时间戳。所以它不会把这个字符串当作毫秒时间戳来解析，而是直接失败（解析成无效日期），但 dayjs 会退化为 Unix epoch（1970 年）或给出错误结果，最终导致返回的是错误的时间。

如何避免此类问题

同dayjs一样，原生的 new Date() 在解析时间戳时也存在类似的问题，因此，不管是 Date 还是 dayjs，一律对后端返回的时间戳 Number(input) 兜底处理，永远不要信任它传的是数字还是字符串：

const ts = Number(res.endTime);
const date = new Date(ts);

思考

其实出现这个问题，除了后端更改时间戳类型，也在于我没有充分理解“时间戳”的含义。我一直以为时间戳就是一段字符或一段数字，因此，从来没有想过做任何兜底处理。那么，什么是时间戳？

时间戳（Timestamp） 是一种用来表示时间的数字，通常表示从某个“起点时刻”到某个指定时间之间所经过的时间长度。这个“起点”大多数情况下是 1970 年 1 月 1 日 00:00:00 UTC（Unix 纪元）。

常见时间戳类型：

时间戳的意义：

• 它是一个 绝对时间的数字化表示，可以跨语言、跨平台统一理解；
• 更容易做计算：两个时间戳相减就能得到毫秒差值（时间间隔）；
• 更紧凑：比如比字符串 "2025-07-17 06:59:59" 更短，处理性能更高。

在 JavaScript 中的使用：

console.log(Date.now()); // 比如：1714729530000

// 将时间戳转为日期
console.log(new Date(1750089599000)); // Thu Jul 17 2025 06:59:59 GMT+0800

关于我

一个热爱技术分享的资深前端工程师，技术栈为Vue、React、Threejs，当然对一些前沿的技术也比较感兴趣，如微前端、鸿蒙开发、油猴脚本开发等。
如果你对前端技术也充满热爱或者希望关注一些前沿技术，欢迎加群讨论~

当然，如果你有任何面试、工作上遇到的技术问题也都可以在群里提问，有时间我就会及时回答~