1. Introduction

When reading an Excel file in Java, we usually want to read the values of cells to perform some computation or generate a report. However, we may encounter one or more cells that contain formulas rather than raw data values. So, how do we get at the actual data values of those cells?

In this tutorial, we’re going to look at different ways to read Excel cell values – rather than the formula that is calculating the cell values – with the Apache POI Java library.

There are two ways to solve this problem:

  • Fetch the last cached value for the cell
  • Evaluate the formula at runtime to get the cell value

2. Maven Dependency

We need to add the following dependency in our pom.xml file for Apache POI:

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.0</version>
</dependency>

The latest version of poi-ooxml can be downloaded from Maven Central.

3. Fetch the Last Cached Value

Excel stores two objects for the cell when a formula calculates its value. One is the formula itself, and the second is the cached value. The cached value contains the last value evaluated by the formula.

So the idea here is we can fetch the last cached value and consider it as cell value. It may not always be true that the last cached value is the correct cell value. However, when we’re working with an Excel file that is saved, and there are no recent modifications to the file, then the last cached value should be the cell value.

Let’s see how to fetch the last cached value for a cell:

FileInputStream inputStream = new FileInputStream(new File("temp.xlsx"));
Workbook workbook = new XSSFWorkbook(inputStream);
Sheet sheet = workbook.getSheetAt(0);

CellAddress cellAddress = new CellAddress("C2");
Row row = sheet.getRow(cellAddress.getRow());
Cell cell = row.getCell(cellAddress.getColumn());

if (cell.getCellType() == CellType.FORMULA) {
    switch (cell.getCachedFormulaResultType()) {
        case BOOLEAN:
            System.out.println(cell.getBooleanCellValue());
            break;
        case NUMERIC:
            System.out.println(cell.getNumericCellValue());
            break;
        case STRING:
            System.out.println(cell.getRichStringCellValue());
            break;
    }
}

4. Evaluate the Formula to Get the Cell Value

Apache POI provides a FormulaEvaluator class, which enables us to calculate the results of formulas in Excel sheets.

So, we can use FormulaEvaluator to calculate the cell value at runtime directly. The FormulaEvaluator class provides a method called evaluateFormulaCell, which evaluates the cell value for the given Cell object and returns a CellType object, which represents the data type of the cell value.

Let’s see this approach in action:

// existing Workbook setup

FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator(); 

// existing Sheet, Row, and Cell setup

if (cell.getCellType() == CellType.FORMULA) {
    switch (evaluator.evaluateFormulaCell(cell)) {
        case BOOLEAN:
            System.out.println(cell.getBooleanCellValue());
            break;
        case NUMERIC:
            System.out.println(cell.getNumericCellValue());
            break;
        case STRING:
            System.out.println(cell.getStringCellValue());
            break;
    }
}

5. Which Approach to Choose

The simple difference between the two approaches here is that the first method uses the last cached value, and the second method evaluates the formula at runtime.

If we’re working with an Excel file that is already saved and we’re not going to make changes to that spreadsheet at runtime, then the cached value approach is better as we don’t have to evaluate the formula.

However, if we know that we’re going to make frequent changes at runtime, then it’s better to evaluate the formula at runtime to fetch the cell value.

6. Conclusion

In this quick article, we saw two ways to get the value of an Excel cell rather than the formula that calculates it.

The complete source code for this article is available over on GitHub.