EasyExcel时间数据导入异常问题分析与解决方案

问题背景

在使用阿里巴巴开源的EasyExcel库进行Excel数据导入时，部分用户反馈在3.3.4版本中存在时间数据导入异常的问题。具体表现为：当使用String类型接收Excel中的时间数据时，导入后的时间比原始数据少了6分钟。例如，Excel中的"4:00:00.000"被解析为"3:54:00.000"。

问题分析

经过技术团队深入调查，发现这个问题实际上从EasyExcel 3.2.0版本就开始出现。时间解析错误的表现形式多样，且看似没有规律：

• Excel原始数据"4:00:00.000"被解析为"4:54:17.000"
• "0:01:42.000"被解析为"0:55:59.000"
• "0:30:00.000"被解析为"0:24:17.000"

问题的根源在于Excel的日期系统存在两种不同的计算方式：

1. 1900日期系统：这是Excel默认使用的日期系统，将1900年1月1日作为基准日（第1天）
2. 1904日期系统：主要用于Macintosh系统，将1904年1月1日作为基准日

在Java语言中处理Excel日期时，如果错误地使用了1904日期系统来处理原本使用1900日期系统的Excel文件，就会导致时间计算出现偏差。

解决方案

临时解决方案

对于使用3.3.4及以下版本的用户，可以通过以下方式临时解决问题：

// 在构建ExcelReader时显式指定使用1904日期系统
EasyExcel.read(file)
    .use1904windowing(true)
    .head(head)
    .registerConverter(new StringConverter())
    .sheet()
    .doRead();

长期解决方案

该问题已在EasyExcel 4.0.3及以上版本中得到修复。建议用户升级到最新版本以获得更好的兼容性和稳定性。

技术深入

Excel日期系统差异

Excel的两种日期系统存在以下关键区别：

1. 1900日期系统：

   • 将1900年1月1日视为第1天
   • 错误地将1900年视为闰年（实际上不是）
   • 这是Windows版Excel的默认设置

2. 1904日期系统：

   • 将1904年1月1日视为第1天
   • 正确处理了闰年计算
   • 这是Mac版Excel的默认设置

时间计算偏差原因

当使用错误的日期系统处理Excel文件时，会导致以下问题：

1. 基准日差异：1900和1904系统之间有1462天的差异（因为1900不是闰年）
2. 时间计算偏移：在转换过程中，时间部分会被错误地缩放或偏移
3. 跨平台兼容性问题：不同操作系统默认使用的日期系统不同

最佳实践建议

1. 明确指定日期系统：在读取Excel文件时，最好明确指定使用哪种日期系统
2. 版本升级：尽可能使用EasyExcel 4.0.3及以上版本
3. 数据类型选择：对于纯时间数据，考虑使用Java 8的LocalTime类型而非String
4. 单元测试：对包含时间数据的Excel导入功能编写充分的测试用例

总结

EasyExcel时间导入异常问题揭示了Excel日期系统处理中的复杂性。通过理解Excel的两种日期系统及其差异，开发者可以更好地处理时间数据导入问题。建议用户根据自身情况选择合适的解决方案，并在可能的情况下升级到已修复该问题的版本。