Apache POI读取.xlsx日期单元格格式异常问题求助

API 探路者

2026-8-6

解决Apache POI读取Excel日期格式与显示不一致的问题

问题原因

Excel日期格式掩码里的-和/是区域相关的占位符，并非固定字符。当Excel所在系统的日期分隔符设为/时，格式掩码mmm-yy会自动渲染为Jan/17；但Apache POI直接读取的是原始格式字符串（mmm-yy），若用默认配置的格式化工具，会按JVM的区域设置解析，导致结果和Excel实际显示不符。

解决方案

核心是基于Excel文件对应的区域设置来格式化日期，而非依赖JVM默认配置或硬替换分隔符。

方法1：指定Locale的DataFormatter

DataFormatter是POI专门用于获取单元格显示文本的工具，传入Excel文件的区域设置后，就能得到和Excel一致的显示结果：

// 获取Excel文件的区域设置
Locale excelLocale = workbook.getCreationHelper().getLocale();
// 初始化带指定Locale的DataFormatter
DataFormatter formatter = new DataFormatter(excelLocale);
// 获取单元格的显示文本
String displayedText = formatter.formatCellValue(cell);

方法2：自定义格式化逻辑（适配复杂场景）

若需更精细控制格式，可手动解析格式字符串并结合Excel区域的日期分隔符处理：

if (DateUtil.isCellDateFormatted(cell)) {
    Date date = cell.getDateCellValue();
    Locale excelLocale = workbook.getCreationHelper().getLocale();
    // 获取Excel区域的日期分隔符
    DateFormatSymbols symbols = new DateFormatSymbols(excelLocale);
    String dateSeparator = symbols.getDateFormatSymbols()[0];
    
    // 替换格式掩码中的占位符为实际分隔符
    String rawPattern = cell.getCellStyle().getDataFormatString();
    String actualPattern = rawPattern.replaceAll("[-/]", dateSeparator);
    
    // 构建格式化器并输出结果
    SimpleDateFormat sdf = new SimpleDateFormat(actualPattern, excelLocale);
    String formattedDate = sdf.format(date);
}