每年1月1日的XLSX解析结果异于其他日期？原因及解决方案咨询

问题原因 #

• Excel日期存储的历史bug：Excel默认采用1900年日期系统，该系统错误地将1900年判定为闰年，导致1900-03-01前的日期序列号存在偏移。1月1日作为日期起点（序列号1），部分解析库在处理这个边界值时，容易触发兼容逻辑错误，和其他日期的解析结果产生差异。
• 解析库的日期处理逻辑缺陷：部分XLSX解析库在自动转换日期时，对1月1日这类特殊日期的格式匹配、时区转换或epoch映射处理不当，导致解析出的日期对象或字符串与实际值不符。
• 单元格格式不一致：若1月1日对应的单元格使用了自定义格式（而非标准日期格式），解析库可能将其识别为文本类型，而非日期类型，进而导致结果差异。

解决办法 #

• 明确指定解析规则：使用解析库时，强制开启日期解析配置并指定日期系统。比如使用xlsx库时，设置{ cellDates: true, dateNF: 'yyyy-mm-dd' }，避免自动转换的歧义。
• 手动校正特殊日期：解析完成后，对结果中的1月1日日期进行校验，若发现解析异常，手动将对应的单元格值转换为正确的日期对象（如基于序列号计算或直接替换为标准日期字符串）。
• 统一文件内的日期格式：生成XLSX文件时，确保所有日期单元格使用标准日期格式，避免自定义格式导致的解析误判。
• 升级或更换解析库：如果当前使用的库存在已知的日期解析bug，升级到最新稳定版本；也可替换为对日期处理更严谨的库（如exceljs）。

内容的提问来源于stack exchange，提问作者月上老狗