当前位置：首页 > news >正文

在 Java 中实现 Excel 数字与文本转换

news 2025/11/15 6:47:21

在数据处理过程中，经常会遇到需要将 Excel 单元格中的文本转换为数字，或将数字转换为文本的情况。这种需求通常出现在数据清理、分析、报告生成等场景中。在本篇文章中，我们将探讨如何使用 Java 来实现 Excel 中数字与文本的互转，结合 Free Spire.XLS 库进行操作。

1. 介绍 Free Spire.XLS

Free Spire.XLS for Java 是一个免费的 Java Excel 库，主要用于读取和写入 Microsoft Excel 格式的文件，包括 XLS、XLSX 等，同时也支持读写 CSV 格式，兼容 OpenOffice 生成的 ODS 和 WPS 生成的 ET 格式。通过该库，我们可以轻松地对 Excel 文件进行各种操作，包括读取数据、写入数据以及转换数据类型。

2. 安装 Free Spire.XLS

在开始之前，确保你的 Java 项目中已包含 Free Spire.XLS 依赖。如果你使用的是 Maven，可以在 pom.xml 文件中添加以下依赖：

<repositories><repository><id>com.e-iceblue</id><name>e-iceblue</name><url>https://repo.e-iceblue.cn/repository/maven-public/</url></repository>
</repositories>
<dependency><groupId>e-iceblue</groupId><artifactId>spire.xls.free</artifactId><version>5.3.0</version>
</dependency>

如果不使用 Maven，可以从 Spire.XLS 官网下载相关的 JAR 文件并将其加入项目中。

3. Excel 数字与文本转换

3.1 将数字转换为文本

在 Excel 中，数字通常会被自动识别为数字类型，若希望将数字转换为文本，可以使用 CellRange.setNumberFormat() 方法将数字以字符串形式设置。

以下是将数字转换为文本的示例：

import com.spire.xls.*;public class ConvertNumberToText {public static void main(String[] args) {// 创建 Workbook 对象Workbook workbook = new Workbook();// 加载 Excel 文件workbook.loadFromFile("C:\\Users\\Administrator\\Desktop\\Employee.xlsx");// 获取指定的工作表Worksheet worksheet = workbook.getWorksheets().get(0);// 获取需要转换的单元格范围CellRange cellRange = worksheet.getRange().get("F2:F9");// 设置单元格格式为文本cellRange.setNumberFormat("@");// 保存修改后的工作簿workbook.saveToFile("output/NumbersToText.xlsx");// 释放资源workbook.dispose();}
}

在这个示例中：

我们加载了名为 Employee.xlsx 的 Excel 文件。
通过设置 NumberFormat 为 "@"，将 F2:F9 范围内的数字转换为文本。
最后，我们保存了修改后的文件为 NumbersToText.xlsx。

3.2 将文本转换为数字

当 Excel 中的文本数据实际上代表的是数字时，我们可能需要将文本转换为数字。Free Spire.XLS 提供了 CellRange.convertToNumber() 方法来完成该转换。

以下是将文本转换为数字的示例：

import com.spire.xls.*;public class ConvertTextToNumber {public static void main(String[] args) {// 创建 Workbook 对象Workbook workbook = new Workbook();// 加载 Excel 文件workbook.loadFromFile("C:\\Users\\Administrator\\Desktop\\Input.xlsx");// 获取指定的工作表Worksheet worksheet = workbook.getWorksheets().get(0);// 获取需要转换的单元格范围CellRange range = worksheet.getRange().get("D2:G13");// 将文本转换为数字range.convertToNumber();// 保存修改后的工作簿workbook.saveToFile("output/TextToNumbers.xlsx");// 释放资源workbook.dispose();}
}

在这个示例中：