使用Apache POI读取含TODAY()函数的公式单元格日期值问题

问题核心 #

目标单元格公式为="text" & TEXT(TODAY();"RRRR-MM-DD") & "text"，现有两种取值方式均异常：

• 用DataFormatter.formatCellValue(cell, evaluator)返回类似45160.0的Excel日期序列号，而非格式化后的日期字符串
• 用cell.richStringCellValue.getString()返回Excel最后保存时的旧日期，无法获取TODAY()的实时值，仅手动打开保存文件后才更新

原因分析 #

1. cell.richStringCellValue()读取的是Excel文件中预缓存的字符串结果，而非实时计算值。TODAY()是易失性函数，只有Excel主动重新计算时才会更新缓存，代码直接读取缓存自然拿不到当前日期。
2. 之前用DataFormatter返回数值，是因为FormulaEvaluator默认优先使用缓存的计算结果，没有触发TODAY()的实时计算，导致TEXT函数的格式化逻辑未生效，返回了原始的日期序列号。

解决方案 #

要强制FormulaEvaluator实时重新计算公式，而非依赖缓存，同时确保正确解析公式的地区格式（公式用分号;作为参数分隔符，对应欧洲地区Locale），步骤如下：

1. 初始化带强制计算配置的FormulaEvaluator #

// 根据你的Workbook类型选择对应Evaluator（XSSF/XSSFFormulaEvaluator，HSSF/HSSFFormulaEvaluator）
FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
// 清空所有缓存结果，强制重新计算
evaluator.clearAllCachedResultValues();
// 忽略缺失的外部工作簿（避免因引用外部文件导致计算失败）
evaluator.setIgnoreMissingWorkbooks(true);

2. 修正单元格取值逻辑 #

先通过Evaluator强制计算单元格，再用DataFormatter格式化结果：

Row row = sheet.getRow(cellReference.getRow());
Cell cell = row.getCell(cellReference.getCol().toInt(), Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);
// 匹配公式的地区Locale（比如用Locale.GERMANY对应分号分隔的公式）
DataFormatter dataFormatter = new DataFormatter(Locale.GERMANY);

if (cell.getCellType() == CellType.FORMULA) {
    // 先触发实时计算
    evaluator.evaluate(cell);
    // 格式化计算后的结果
    return dataFormatter.formatCellValue(cell, evaluator);
}

额外注意事项 #

• 确保使用Apache POI 4.1.2及以上版本，旧版本对易失性函数的实时计算支持存在缺陷。
• 如果公式使用逗号,作为参数分隔符，将Locale改为Locale.US即可。

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