引：

最近在调试项目时，我遇到了一个非常经典、但也非常恶心的问题：

Excel 里的日期是：2026-05-01导入系统后却变成了：2026-04-30

而且：

• Excel 看起来是对的
• 前端显示有问题
• 数据库存进去又变了
• 接口返回还不一样

最离谱的是：

你以为是 Excel 的问题，后来发现是 JS；你以为是 JS 的问题，后来发现 MySQL 也参与了；最后发现——整个链路都有坑。

今天这篇文章，我把这个问题彻底讲明白。

举个例子。

Excel 中：

前端读取 Excel 后：

console.log(item.date)

输出：

Thu Apr 30 2026 16:00:00 GMT+0000

然后页面显示：

2026-04-30

日期直接少一天。

后来发现：

Excel 根本没有时区。

Excel 内部存储日期，其实是一个数字。

例如：

2026-05-01=45778

它只是：

“从某一天开始累计的天数”

本质上：

Excel 的日期 ≠ JavaScript Date

真正的问题，出现在：

XLSX → JavaScript Date

这一步。

很多项目都会这样读取 Excel：

const workbook = XLSX.read(fileData, {  cellDates: true})

或者：

const rows = XLSX.utils.sheet_to_json(ws, {  raw: false})

然后：

console.log(rows)

得到：

{date: Date(...)}

注意：

这里已经不是“日期”了，而是“时间对象”。

而 JS 的 Date，天生带时区。

老刘这样写的：

new Date("2026-05-01")

看起来没问题。

实际上：

new Date("2026-05-01")

等价于：

new Date("2026-05-01T00:00:00.000Z")

注意最后那个：

Z = UTC 时区

而中国时间是：

UTC+8

所以：

2026-05-01 00:00:00 UTC=2026-05-01 08:00:00 中国时间

接下来如果再经过：

toISOString ()

或者：

JSON.stringify()

就会再次转 UTC。

于是：

2026-05-01↓UTC↓时区转换↓2026-04-30

Bug 出现了。

这是整个问题的核心。

很多业务里的字段：

• 出生日期
• 开票日期
• 合同日期
• 账单日期
• Excel 导入日期

它们其实都只是：

日期

不是：

时间点

老刘用了这个：

new Date()

于是：

一个“日期”被强行变成了“带时区的时间”

后面所有系统都会开始转换。

很多数据库字段会这样设计：

create_time timestamp

问题来了。

timestamp 会自动转换时区

例如：

存储时：转 UTC读取时：再转本地时间

于是：

2026-05-01 00:00:00

可能会变成：

2026-04-30 16:00:00 UTC

如果前端再转一次：

日期就少一天。

后来老刘终于意识到：

“纯日期”不要使用 Date

这是核心原则。

正确方案

整个链路：

全部使用 yyyy-MM-dd 字符串

例如：

2026-05-01

不要：

Date

不要：

ISOString

不要：

timestamp

前端Excel读取

不要：

cellDates : true

正确：

const workbook = XLSX.read(data, {  cellDates: false})

然后：

const rows = XLSX.utils.sheet_to_json(ws, {  raw: false})

这样得到的：

{    date:"2026-05-01"}

是字符串。

不是 Date。

后端正确写法

不要：

DateTimestampLocalDateTime

正确：

LocalDate

例如：

@JsonFormat(pattern ="yyyy-MM-dd")private LocalDate billDate;

数据库正确写法

不要：

timestamp

正确：

date

因为你存储的是：

日期

不是：

时间

日期 ≠ 时间

如果业务只关心：

2026-05-01

那么：

永远使用字符串：yyyy-MM-dd

不要：

• new Date()
• toISOString()
• timestamp
• UTC 转换

这样可以避免 90% 的日期问题。

以前我一直觉得：

“日期少一天”只是个小 Bug。

后来才发现：

它背后其实是：Excel、JavaScript、JSON、MySQL、时区系统共同作用的结果。

而且这个坑：

几乎所有前端和后端都会踩。

如果你也遇到过：

• 日期少一天
• 时区错乱
• Excel 导入异常
• new Date() 神秘问题

欢迎留言交流。

 欢迎关注我的公众号，可以点击在看、给个小红心点个赞。