如何用Apache POI生成Excel时让日期单元格归为Date格式而非Custom

我用Java的Apache POI生成Excel文件，给部分单元格设置日期格式，但打开文件后发现这些日期单元格在Excel里被归类为Custom（自定义）格式，而非Date（日期）格式。

我的代码如下：

private void createCell(Workbook wb, Sheet sheet, Row row, int columnCount, Object value) {
    Cell cell = row.createCell(columnCount);

    if (value instanceof Date) {
        // 创建自定义日期格式的CellStyle
        CellStyle dateCellStyle = wb.createCellStyle();
        CreationHelper createHelper = wb.getCreationHelper();
        
        // 设置自定义日期格式 "dd-MM-yyyy"
        dateCellStyle.setDataFormat(createHelper.createDataFormat().getFormat("dd-MM-yyyy"));

        // 设置单元格值并应用样式
        cell.setCellValue((Date) value);
        cell.setCellStyle(dateCellStyle);
    } else if (value instanceof Integer) {
        cell.setCellValue((Integer) value);
    } else if (value instanceof Boolean) {
        cell.setCellValue((Boolean) value);
    } else if (value instanceof String) {
        cell.setCellValue((String) value);
    } else {
        cell.setCellValue(value != null ? value.toString() : "");
    }
}

已尝试的方法：

• 使用不同的日期格式，如dd-MM-yyyy或MM/dd/yy；
• 禁用额外样式，仅测试日期值的显示情况；
• 设置特定区域格式，如Locale.US或Locale.UK；
• 手动检查生成文件在Excel中的区域设置。

我的目标：

• 让单元格在Excel中归为Date格式而非Custom格式。

请问是否有办法确保单元格默认归为Excel的Date格式？若没有，最佳实现方式是什么？

核心原因 #

Excel只会将原生内置的日期格式标记为Date类型，哪怕你自定义的格式和内置格式完全一致，也会被归类为Custom。你的代码中用了自定义格式字符串，所以才会出现这个问题。

实现方法：使用Excel内置日期格式索引 #

你需要替换自定义格式字符串为Excel内置的日期格式索引，不同类型的Workbook（HSSF/XLS、XSSF/XLSX）对应不同的索引规则：

修改日期处理部分的代码如下：

if (value instanceof Date) {
    CellStyle dateCellStyle = wb.createCellStyle();
    CreationHelper createHelper = wb.getCreationHelper();
    
    short dateFormatIndex;
    if (wb instanceof HSSFWorkbook) {
        // HSSF（.xls）内置日期格式索引示例：
        // 14 = yyyy-MM-dd, 15 = MM/dd/yy, 16 = dd-MM-yy
        dateFormatIndex = 16; // 对应dd-MM-yy，可根据需求调整
    } else if (wb instanceof XSSFWorkbook) {
        // XSSF（.xlsx）通过内置格式名称获取索引
        dateFormatIndex = BuiltinFormats.getBuiltinFormat("dd-MM-yyyy");
        // 如果返回-1，说明该格式不是Excel原生内置，只能退化为自定义格式
        if (dateFormatIndex == -1) {
            dateFormatIndex = createHelper.createDataFormat().getFormat("dd-MM-yyyy");
        }
    } else {
        // 其他Workbook类型默认使用自定义格式
        dateFormatIndex = createHelper.createDataFormat().getFormat("dd-MM-yyyy");
    }
    
    dateCellStyle.setDataFormat(dateFormatIndex);
    cell.setCellValue((Date) value);
    cell.setCellStyle(dateCellStyle);
}

最佳实践 #

1. 优先用内置格式：只有Excel原生内置的日期格式才能被标记为Date类型，优先选择符合需求的内置格式；
2. 接受自定义格式的局限性：如果你的目标格式不属于Excel内置（比如部分小众地区格式），只能接受它显示为Custom——这不会影响日期的核心功能（排序、筛选、公式计算等依然正常）；
3. 兼容不同Workbook类型：HSSF和XSSF的内置格式索引有差异，代码中要做区分处理，避免兼容性问题。

内容的提问来源于stack exchange，提问作者Sandeep pradeep