Java 操作 Excel：生成数据、设置单元格样式、设置数据有效性（hutool）

shijialeya.2023-10-16 23:18

必读信息

该篇文章，主要通过 Java 代码对 Excel 文件的常用操作，包括：生成表格、修改单元格样式、设置数据有效性。

该篇文章，在官网文献下增加个人的看法和理解，如文中有出现不符、错误或需要补充的地方，欢迎指正，非常感谢。

该篇文章操作 Excel 使用了 hutool 的工具包以及 poi 的依赖，其中 hutool 是一个超级无敌宇宙 perfect 的一个工具包，建议每一个 Java 程序员都要了解下（不是广告，真的不是广告 😊）。

首先给出下面所有案例代码使用的依赖：

  • gradle 项目

    groovy 复制代码 
    // hutool 依赖，我这里使用的是目前最新的版本 5.8.21
implementation 'cn.hutool:hutool-all:5.8.21'
// 操作 Excel 的必须依赖
implementation 'org.apache.poi:poi-ooxml:5.2.3'
implementation 'xerces:xercesImpl:2.12.2'
// 日志依赖，非必须引入，如果项目中已经引入过那就去掉下面两个依赖
testImplementation 'io.basc.framework:log4j2:1.8.3'
implementation 'org.apache.logging.log4j:log4j-core:2.20.0'

  • maven 项目

    xml 复制代码 
    <!-- hutool 依赖，我这里使用的是目前最新的版本 5.8.21 -->
<dependency>
  <groupId>cn.hutool</groupId>
  <artifactId>hutool-all</artifactId>
  <version>5.8.21</version>
</dependency>
<!-- 操作 Excel 的必须依赖 -->
<dependency>
  <groupId>org.apache.poi</groupId>
  <artifactId>poi-ooxml</artifactId>
  <version>5.2.3</version>
</dependency>
<dependency>
  <groupId>xerces</groupId>
  <artifactId>xercesImpl</artifactId>
  <version>2.12.2</version>
</dependency>
<!-- 日志依赖，非必须引入，如果项目中已经引入那就无需引入下面两个依赖 -->
<dependency>
  <groupId>io.basc.framework</groupId>
  <artifactId>log4j2</artifactId>
  <version>1.8.3</version>
</dependency>
<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-core</artifactId>
  <version>2.20.0</version>
</dependency>

非常重要的提示：hutool 的版本与 poi-ooxml、xercesImpl 要对应，不然你会看见你代码都是红色的，版本选择参考 hutool 文档下的这句话：

说明 hutool-4.x 的 poi-ooxml 版本需高于 3.17（别问我 3.8 版本为啥不行，因为 3.17 > 3.8 ） hutool-5.x的 poi-ooxml 版本需高于 4.1.2 hutool-5.6.x支持 poi-ooxml 版本高于 5.0.0 xercesImpl版本高于 2.12.0（非必须）

生成表格

用 hutool 生成 Excel 超级超级简单，在 hutool 官方文档上也给出了多种生成 Excel 的案例方法：https://hutool.cn/docs/#/poi/Excel生成-ExcelWriter

List 生成表格数据

通过 List 写入数据，可以一次写入一行，也可以一次性写入多行，下面代码用了一些 hutool 的工具类，需要注意引入的 import 。

下面有几个比较重要的方法：

  • ExcelUtil.getWriter()：新建一个空的 Excel 文件，可以传入布尔值，true / false 生成 xlsx / xls 文件。
  • writer.writeHeadRow()：该方法用于写入表头数据，之所以用这个方法写入表头，可以方便设置表头的样式。
  • writer.writeRow()：向表格中写入单行数据。
  • writer.write()：向表格中写入数据，该方法有很多重载方法。
  • writer.flush()：将 excel 文件写入到本地磁盘。
  • writer.close()：资源释放，流操作完都要进行释放。
java 复制代码 
package top.shijialeya.hutool;

import cn.hutool.core.lang.UUID;
import cn.hutool.poi.excel.ExcelUtil;
import cn.hutool.poi.excel.ExcelWriter;

import java.io.File;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

/**
 * @author 17279
 */
public class ExcelDemo01 {
    public static void main(String[] args) {
        // 生成一个新的 excel 文件（参数：true 生成 xlsx 文件；false 生成 xls 文件；）
        ExcelWriter writer = ExcelUtil.getWriter(true);

        // 向 excel 中写入表头信息
        writer.writeHeadRow(Arrays.asList("唯一标识", "账户编码", "用户姓名", "账号状态"));

        // 一次性向 excel 中写入一行数据
        List<String> rowData = Arrays.asList(UUID.randomUUID().toString(true), "001", "派大星", "正常状态");
        writer.writeRow(rowData);

        // 一次性向 excel 中写入多行数据
        List<List<String>> multiRowData = new ArrayList<>();
        multiRowData.add(Arrays.asList(UUID.randomUUID().toString(true), "002", "海绵宝宝", "正常状态"));
        multiRowData.add(Arrays.asList(UUID.randomUUID().toString(true), "003", "章鱼哥", "正常状态"));
        multiRowData.add(Arrays.asList(UUID.randomUUID().toString(true), "004", "瘸老板", "禁用状态"));
        writer.write(multiRowData);

        // 将 excel 文件保存到本地
        writer.flush(new File("D:\\test.xlsx"));

        // 资源释放
        writer.close();
    }
}

生成的文件如下：

Map 生成表格数据

通过 Map 的键值对向 Excel 中添加数据。有两个需要注意的地方：

  1. 表格的表头会按照数组中第一个 Map 的 key 生成，比如说：我在第二个 Map 中存在一个 key 为性别的值，但第一个 Map 中并没有性别 key，那么生成的表格中将不会有性别这一列，生成的表头只以数组的第一个 Map 的 key 生成。
  2. 这种方式生成的表格，列的顺序是没法控制的。
java 复制代码 
// 生成一个新的 excel 文件（参数：true 生成 xlsx 文件；false 生成 xls 文件；）
ExcelWriter writer = ExcelUtil.getWriter(true);

// 创建 Map 的集合对象
List<Map<String, Object>> rowData = new ArrayList<>();
rowData.add(new HashMap<String, Object>() {{
  put("唯一标识", UUID.randomUUID().toString(true));
  put("账户编码", "001");
  put("用户姓名", "派大星");
  put("账号状态", "正常状态");
}});
rowData.add(new HashMap<String, Object>() {{
  put("唯一标识", UUID.randomUUID().toString(true));
  put("账户编码", "002");
  put("用户姓名", "海绵宝宝");
  put("账号状态", "正常状态");
}});
rowData.add(new HashMap<String, Object>() {{
  put("唯一标识", UUID.randomUUID().toString(true));
  put("账户编码", "003");
  put("用户姓名", "章鱼哥");
  put("账号状态", "正常状态");
}});
rowData.add(new HashMap<String, Object>() {{
  put("唯一标识", UUID.randomUUID().toString(true));
  put("账户编码", "004");
  put("用户姓名", "瘸老板");
  put("账号状态", "禁用状态");
}});

// 一次性写出内容，使用默认样式
writer.write(rowData);

// 将 excel 文件保存到本地
writer.flush(new File("D:\\test.xlsx"));

// 资源释放
writer.close();

生成的文件如下：

实体类生成表格数据

通过自定的实体对象生成 Excel，主要注意以下两点：

  1. 生成列的顺序和定义实体字段的顺序一致。
  2. @Alias() 注解可以用于设置实体属性与列的别名，如果没有设置那么列名为实体的属性名称。除此之外，还可以通过方法 writer.addHeaderAlias(实体字段名称, 字段别名) 来灵活设置别名。
java 复制代码 
// 自定的实体对象
import cn.hutool.core.annotation.Alias;

public class User {
    @Alias(value = "唯一标识")
    private String id;
    @Alias(value = "账户编码")
    private String code;
    @Alias(value = "用户姓名")
    private String username;
    @Alias(value = "账号状态")
    private String status;
  
		// 【注意】 getter\setter 方法这里省略，自己生成一下就好了
  
    public User(String id, String code, String username, String status) {
        this.id = id;
        this.code = code;
        this.username = username;
        this.status = status;
    }
}
java 复制代码 
// 生成一个新的 excel 文件（参数：true 生成 xlsx 文件；false 生成 xls 文件；）
ExcelWriter writer = ExcelUtil.getWriter(true);

// 创建集合对象
List<User> userList = new ArrayList<>();
userList.add(new User(UUID.randomUUID().toString(true), "001",  "派大星", "正常状态"));
userList.add(new User(UUID.randomUUID().toString(true), "002",  "海绵宝宝", "正常状态"));
userList.add(new User(UUID.randomUUID().toString(true), "003",  "章鱼哥", "正常状态"));
userList.add(new User(UUID.randomUUID().toString(true), "004",  "瘸老板", "禁用状态"));

// 自定义别名
// writer.addHeaderAlias("id", "唯一标识");
// writer.addHeaderAlias("code", "账户编码");
// ...

// 写出内容
writer.write(userList);

// 将 excel 文件保存到本地
writer.flush(new File("D:\\test.xlsx"));

// 资源释放
writer.close();

生成的文件如下：

指定单元格生成数据

向指定位置的单元格写入指定的数据，这种方式一般很少用。不过这种方式能满足绝大部分的应用场景。

主要使用了下面的这个方法：

  • excel.writeCellValue()：向指定单元格中写入数据，方法有三个参数：列号、行号、单元格的值，行号 0 开始
java 复制代码 
// 生成一个新的 excel 文件（参数：true 生成 xlsx 文件；false 生成 xls 文件；）
ExcelWriter writer = ExcelUtil.getWriter(true);

// 一次性向 excel 中写入多行数据
List<List<String>> rowData = new ArrayList<List<String>>() {{
  add(Arrays.asList("唯一标识", "账户编码", "用户姓名", "账号状态"));
  add(Arrays.asList(UUID.randomUUID().toString(true), "001", "派大星", "正常状态"));
  add(Arrays.asList(UUID.randomUUID().toString(true), "002", "海绵宝宝", "正常状态"));
  add(Arrays.asList(UUID.randomUUID().toString(true), "003", "章鱼哥", "正常状态"));
  add(Arrays.asList(UUID.randomUUID().toString(true), "004", "瘸老板", "禁用状态"));
}};

// 遍历每一行的数据，索引 0 开始
for (int rowNum = 0; rowNum < rowData.size(); rowNum++) {
  List<String> cellData = rowData.get(rowNum);
  // 遍历该行每一个单元格，索引 0 开始
  for (int cellNum = 0; cellNum < cellData.size(); cellNum++) {
    // 向每一个单元格中设置值（参数：列号、行号、单元格的值，行号 0 开始）
    writer.writeCellValue(cellNum, rowNum, cellData.get(cellNum));
  }
}

// 将 excel 文件保存到本地
writer.flush(new File("D:\\test.xlsx"));

// 资源释放
writer.close();

生成的文件如下：

修改单元格样式

这个修改表格的样式感觉工具里面有很多 bug，遇到的问题我会一一列出来。

行高和列宽

  • 设置默认的行高，所有的行高

    writer.setDefaultRowHeight(height) 行高范围：0 ~ 409，为 0 时表示隐藏。

  • 指定列的列宽

    writer.setColumnWidth(columnIndex, width) 列宽范围：0 ~ 255 字符，0 表示为隐藏，列号从 0 开始。

  • 指定行的行高

    writer.setRowHeight(rownum, height) 行高范围：0 ~ 409，为 0 时表示隐藏，行号从 0 开始。

需要特别注意的是：setDefaultRowHeight() 和 setRowHeight() 方法不能一起使用，当两者同时出现时，只会生效 setRowHeight() 方法的内容，而 setDefaultRowHeight() 完全不起效果。

案例代码：

java 复制代码 
// 指定默认的行高
writer.setDefaultRowHeight(25);
// 给指定列设置列宽，列的索引 0 开始（宽度单位：字符 1 ~ 256）
writer.setColumnWidth(0, 36);
// 给指定行设置行高，与 setDefaultRowHeight() 选择其一 
// writer.setRowHeight(1, 35);

结果：

表头样式

在 hutool 操作 excel 有一个表头的概念

  • 通过 writer.writeHeadRow() 写入表格数据，这个数据就是表头的数据。
  • 通过 writer.write() 写入 Map 类型的数据，Map 的 key 也是表头数据。
  • 通过实体对象写入表格，注解 @Alias 指定的名称也为表头数据。
  • 当通过 writer.writeCellValue() 方法写入的数据不属于表头。

默认生成的表头是灰底黑字居中的样式：

可以对表头的样式进行修改：

java 复制代码 
// 获得表头单元格样式对象
CellStyle headCellStyle = writer.getHeadCellStyle();
// 设置表头前景色
headCellStyle.setFillForegroundColor(IndexedColors.LIGHT_YELLOW.getIndex());
// 创建字体样式
Font headCellFont = writer.createFont();
// 设置字体颜色
headCellFont.setColor(IndexedColors.DARK_RED.index);
// 设置字体大小
headCellFont.setFontHeightInPoints((short) 12);
// 设置字体类型
headCellFont.setFontName("Microsoft YaHei UI");
// 设置字体加粗
headCellFont.setBold(true);
// 设置斜体
headCellFont.setItalic(true);
// 设置删除线
headCellFont.setStrikeout(true);
headCellStyle.setFont(headCellFont);

效果如下：

设置全局样式

这种方式可以修改除表头以外含有数据的单元格样式，表头的样式不会修改。

java 复制代码 
// 设置前景色（下面两个语句）
rowStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
rowStyle.setFillForegroundColor(IndexedColors.LIGHT_YELLOW.getIndex());
// 创建字体样式
Font cellFont = writer.createFont();
// 设置字体颜色
cellFont.setColor(IndexedColors.DARK_RED.index);
// 设置字体大小
cellFont.setFontHeightInPoints((short) 16);
// 设置字体类型
cellFont.setFontName("Microsoft YaHei UI");
rowStyle.setFont(cellFont);

效果如下：

设置行样式

这里有几个坑的地方：

  • 设置背景色的时候只能用 setFillPattern() 和 setFillForegroundColor() 两个方法共同控制，setFillBackgroundColor() 和 setFillForegroundColor() 这两个方法不能无法修改背景的颜色。【这里巨坑】
  • 在设置字体样式的时候，我们通过 writer.createFont() 创建的字体，这个字体不在 CellStyle 上，所以要重新执行 setFont() 和 setRowStyleIfHasData()。
  • 跟 writer.setRowStyleIfHasData() 有一个类似的 setRowStyle() 方法，如果使用的是 setRowStyle() 方法，那么行单元格中存在数据的单元格的样式会被替换，也就是有内容的单元格样式不会有效果。【这里也巨坑】

案例代码：

java 复制代码 
// 获得第二行的样式
CellStyle rowStyle = writer.getOrCreateRowStyle(1);
// 设置前景色（下面两个语句）
rowStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
rowStyle.setFillForegroundColor(IndexedColors.LIGHT_YELLOW.getIndex());
// 创建字体样式
Font cellFont = writer.createFont();
// 设置字体颜色
cellFont.setColor(IndexedColors.DARK_RED.index);
// 设置字体大小
cellFont.setFontHeightInPoints((short) 16);
// 设置字体类型
cellFont.setFontName("Microsoft YaHei UI");
rowStyle.setFont(cellFont);
// 设置第二行的表格样式（要重新设置 Style）
writer.setRowStyleIfHasData(1, rowStyle);

效果如下：

设置列样式

方式与设置单行样式相近，获取样式和设置样式的方法不一样：

writer.getOrCreateColumnStyle() 获取列的样式对象。

writer.setColumnStyleIfHasData() 方法有三个参数：列号、开始行号、样式，列号和行号都是 0 开始。

java 复制代码 
// 获得第二列的样式
CellStyle rowStyle = writer.getOrCreateColumnStyle(1);
// 设置前景色（下面两个语句）
rowStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
rowStyle.setFillForegroundColor(IndexedColors.LIGHT_YELLOW.getIndex());
// 创建字体样式
Font cellFont = writer.createFont();
// 设置字体颜色
cellFont.setColor(IndexedColors.DARK_RED.index);
// 设置字体大小
cellFont.setFontHeightInPoints((short) 16);
// 设置字体类型
cellFont.setFontName("Microsoft YaHei UI");
rowStyle.setFont(cellFont);
// 设置第二列的表格样式（参数：列号、开始行号、样式，列号和行号都是 0 开始）
writer.setColumnStyleIfHasData(1, 1, rowStyle);

效果如下：

指定单元格样式

选定指定的单元格，修改单元格的样式：

java 复制代码 
// 获得第二行第二列的样式
CellStyle rowStyle = writer.createCellStyle(1, 1);
// 设置前景色（下面两个语句）
rowStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
rowStyle.setFillForegroundColor(IndexedColors.LIGHT_YELLOW.getIndex());
// 创建字体样式
Font cellFont = writer.createFont();
// 设置字体颜色
cellFont.setColor(IndexedColors.DARK_RED.index);
// 设置字体大小
cellFont.setFontHeightInPoints((short) 16);
// 设置字体类型
cellFont.setFontName("Microsoft YaHei UI");
rowStyle.setFont(cellFont);

效果如下：

设置数据有效性

Excel 的数据有效性有以下几种：

上面有八种数据有效性（任何值、整数、小数、序列、日期、时间、文本长度、自定义），但在 POI 中可以认为存在以下几种类型：

  1. CellType.NUMERIC 数值类型，包括：整数、小数、日期、时间。
  2. CellType.STRING 字符串类型，包括：任何值、序列、文本长度。
  3. CellType.FORMULA 公式类型，包括：自定义。
  4. CellType.BLANK 空值，只要是单元格为空，都是这个类型。
  5. CellType.BOOLEAN 布尔类型。（没怎么用到这个）
  6. CellType.ERROR 错误单元格。（没怎么用到这个）

整数

如下案例：设置单元格只能输入 1 ~ 100 的整数。

java 复制代码 
// 创建 Excel 文件
ExcelWriter writer = ExcelUtil.getWriter(new File("D:\\code\\xxx.xlsx"));
Sheet sheet = writer.getSheet();
// 插入表头数据
writer.writeHeadRow(new ArrayList<String>() {{
  add("年龄");
}});
// 设置数据有效性
String minNum = "1";
String maxNum = "100";
// 创建数据有效性助手对象
DataValidationHelper helper = sheet.getDataValidationHelper();
// 创建整数有效性
// 参数1：BETWEEN 介于两者之间；NOT_BETWEEN 不在两者之间；EQUAL 相等；NOT_EQUAL 不等；GREATER_THAN 大于；LESS_THAN 小于；GREATER_OR_EQUAL 大于等于；LESS_OR_EQUAL 小于等于；
DataValidationConstraint constraint = helper.createIntegerConstraint(DataValidationConstraint.OperatorType.BETWEEN, minNum, maxNum);
// 四个参数分别是：起始行、终止行、起始列、终止列（需要注意，因为表头已经占了一行，所以行以 1 开始）
DataValidation validation = helper.createValidation(constraint, new CellRangeAddressList(1, 65535, 0, 0));
validation.createErrorBox("输入有误", String.format("请输入%s~%s之间的整数", minNum, maxNum));
// 文件兼容处理【必须】
if (validation instanceof XSSFDataValidation) {
  validation.setShowErrorBox(true);
  validation.setSuppressDropDownArrow(true);
} else {
  validation.setSuppressDropDownArrow(false);
}
sheet.addValidationData(validation);
// 资源释放
writer.close();

效果如下：

需要注意的地方：

  • CellRangeAddressList(1, 65535, 0, 0) 方法处，这里没办法控制列下的所有行，只能通过指定范围的行，65535 还可以换成更大的数，行列的索引从 0 开始。
  • 文件兼容处理的代码必须要加上，不然会出现不生效的问题。

小数

如下案例：设置单元格只能输入 1 ~ 3 的数值。

java 复制代码 
// 创建 Excel 文件
ExcelWriter writer = ExcelUtil.getWriter(new File("D:\\code\\xxx.xlsx"));
Sheet sheet = writer.getSheet();
// 插入表头数据
writer.writeHeadRow(new ArrayList<String>() {{
  add("身高（m）");
}});
// 设置数据有效性
String minNum = "0";
String maxNum = "3";
// 创建数据有效性助手对象
DataValidationHelper helper = sheet.getDataValidationHelper();
// 创建整数有效性
// 参数1：ANY 任意值；INTEGER 整数；DECIMAL 小数；LIST 列表；DATE 时间；TIME 时间；TEXT_LENGTH 文本长度；FORMULA 正则/公式；
// 参数2：BETWEEN 介于两者之间；NOT_BETWEEN 不在两者之间；EQUAL 相等；NOT_EQUAL 不等；GREATER_THAN 大于；LESS_THAN 小于；GREATER_OR_EQUAL 大于等于；LESS_OR_EQUAL 小于等于；
DataValidationConstraint constraint = helper.createNumericConstraint(
  DataValidationConstraint.ValidationType.DECIMAL,
  DataValidationConstraint.OperatorType.BETWEEN,
  minNum,
  maxNum
);
// 四个参数分别是：起始行、终止行、起始列、终止列（需要注意，因为表头已经占了一行，所以以 1 开始）
DataValidation validation = helper.createValidation(constraint, new CellRangeAddressList(1, 65536, 0, 0));
validation.createErrorBox("输入有误", String.format("请输入%s~%s之间的数值", minNum, maxNum));
// 文件兼容处理【必须】
if (validation instanceof XSSFDataValidation) {
  validation.setShowErrorBox(true);
  validation.setSuppressDropDownArrow(true);
} else {
  validation.setSuppressDropDownArrow(false);
}
sheet.addValidationData(validation);
// 资源释放
writer.close();

效果如下：

序列/下拉

如下案例：添加下拉选择功能。

java 复制代码 
// 创建 Excel 文件
ExcelWriter writer = ExcelUtil.getWriter(new File("D:\\code\\xxx.xlsx"));
Sheet sheet = writer.getSheet();
// 插入表头数据
writer.writeHeadRow(new ArrayList<String>() {{
  add("序列/下拉");
}});
// 设置数据有效性
// 创建数据有效性助手对象
DataValidationHelper helper = sheet.getDataValidationHelper();
// 创建整数有效性
DataValidationConstraint constraint = helper.createExplicitListConstraint(
  new String[]{"类型1", "类型2", "类型3"}
);
// 四个参数分别是：起始行、终止行、起始列、终止列（需要注意，因为表头已经占了一行，所以以 1 开始）
DataValidation validation = helper.createValidation(constraint, new CellRangeAddressList(1, 65536, 0, 0));
validation.createErrorBox("输入有误", "请选择下拉选项的值");
// 文件兼容处理【必须】
if (validation instanceof XSSFDataValidation) {
  validation.setShowErrorBox(true);
  validation.setSuppressDropDownArrow(true);
} else {
  validation.setSuppressDropDownArrow(false);
}
sheet.addValidationData(validation);
// 资源释放
writer.close();

效果如下：

日期

如下案例：

java 复制代码 
// 创建 Excel 文件
ExcelWriter writer = ExcelUtil.getWriter(new File("D:\\code\\xxx.xlsx"));
Sheet sheet = writer.getSheet();
// 插入表头数据
writer.writeHeadRow(new ArrayList<String>() {{
  add("日期");
}});
// 设置数据有效性
String min = "date(1970,1,1)";
String max = "date(2024,12,32)";
// 创建数据有效性助手对象
DataValidationHelper helper = sheet.getDataValidationHelper();
// 创建整数有效性
// 参数1：BETWEEN 介于两者之间；NOT_BETWEEN 不在两者之间；EQUAL 相等；NOT_EQUAL 不等；GREATER_THAN 大于；LESS_THAN 小于；GREATER_OR_EQUAL 大于等于；LESS_OR_EQUAL 小于等于；
DataValidationConstraint constraint = helper.createDateConstraint(
  DataValidationConstraint.OperatorType.BETWEEN, min, max, "YYYY/MM/DD"
);
// 四个参数分别是：起始行、终止行、起始列、终止列（需要注意，因为表头已经占了一行，所以以 1 开始）
DataValidation validation = helper.createValidation(constraint, new CellRangeAddressList(1, 65536, 0, 0));
validation.createErrorBox("输入有误", String.format("请输入%s~%s范围内的日期值", "1970/1/1", "2024/12/32"));
// 文件兼容处理【必须】
if (validation instanceof XSSFDataValidation) {
  validation.setShowErrorBox(true);
  validation.setSuppressDropDownArrow(true);
} else {
  validation.setSuppressDropDownArrow(false);
}
sheet.addValidationData(validation);
// 资源释放
writer.close();

效果如下：

特别注意：

  • helper.createDateConstraint(OperatorType, min, max, dateFormat) 设置 min，max 时，一定要用 date() 函数，如 date(2020,12,12)

时间

案例如下：

java 复制代码 
// 创建 Excel 文件
ExcelWriter writer = ExcelUtil.getWriter(new File("D:\\code\\xxx.xlsx"));
Sheet sheet = writer.getSheet();
// 插入表头数据
writer.writeHeadRow(new ArrayList<String>() {{
  add("日期");
}});
// 设置数据有效性
String min = "time(9,0,0)";
String max = "time(18,0,0)";
// 创建数据有效性助手对象
DataValidationHelper helper = sheet.getDataValidationHelper();
// 创建整数有效性
// 参数1：BETWEEN 介于两者之间；NOT_BETWEEN 不在两者之间；EQUAL 相等；NOT_EQUAL 不等；GREATER_THAN 大于；LESS_THAN 小于；GREATER_OR_EQUAL 大于等于；LESS_OR_EQUAL 小于等于；
DataValidationConstraint constraint = helper.createTimeConstraint(
  DataValidationConstraint.OperatorType.BETWEEN, min, max
);
// 四个参数分别是：起始行、终止行、起始列、终止列（需要注意，因为表头已经占了一行，所以以 1 开始）
DataValidation validation = helper.createValidation(constraint, new CellRangeAddressList(1, 65536, 0, 0));
validation.createErrorBox("输入有误", String.format("请输入%s~%s范围内的时间值", "9:00:00", "18:00:00"));
// 文件兼容处理【必须】
if (validation instanceof XSSFDataValidation) {
  validation.setShowErrorBox(true);
  validation.setSuppressDropDownArrow(true);
} else {
  validation.setSuppressDropDownArrow(false);
}
sheet.addValidationData(validation);
// 资源释放
writer.close();

效果如下：

特别注意：

  • helper.createTimeConstraint() 传递的 time 值要用 time()，如：time(12,30,0)

文本长度

案例如下：

java 复制代码 
// 创建 Excel 文件
ExcelWriter writer = ExcelUtil.getWriter(new File("D:\\code\\xxx.xlsx"));
Sheet sheet = writer.getSheet();
// 插入表头数据
writer.writeHeadRow(new ArrayList<String>() {{
  add("字符");
}});
// 设置数据有效性
String min = "0";
String max = "10";
// 创建数据有效性助手对象
DataValidationHelper helper = sheet.getDataValidationHelper();
// 创建整数有效性
// 参数1：BETWEEN 介于两者之间；NOT_BETWEEN 不在两者之间；EQUAL 相等；NOT_EQUAL 不等；GREATER_THAN 大于；LESS_THAN 小于；GREATER_OR_EQUAL 大于等于；LESS_OR_EQUAL 小于等于；
DataValidationConstraint constraint = helper.createTextLengthConstraint(DataValidationConstraint.OperatorType.BETWEEN, min, max);
// 四个参数分别是：起始行、终止行、起始列、终止列（需要注意，因为表头已经占了一行，所以以 1 开始）
DataValidation validation = helper.createValidation(constraint, new CellRangeAddressList(1, 65536, 0, 0));
validation.createErrorBox("输入有误", String.format("请输入%s以内的字符数", max));
// 文件兼容处理【必须】
if (validation instanceof XSSFDataValidation) {
  validation.setShowErrorBox(true);
  validation.setSuppressDropDownArrow(true);
} else {
  validation.setSuppressDropDownArrow(false);
}
sheet.addValidationData(validation);
// 资源释放
writer.close();

效果如下：

本篇文章加入了一些本人狭隘的想法和理解，如有出现错误之处，欢迎指正，非常感谢。

相关推荐
考虑考虑11 小时前
Jpa使用union all
java·spring boot·后端
用户37215742613511 小时前
Java 实现 Excel 与 TXT 文本高效互转
java
浮游本尊12 小时前
Java学习第22天 - 云原生与容器化
java
渣哥14 小时前
原来 Java 里线程安全集合有这么多种
java
间彧14 小时前
Spring Boot集成Spring Security完整指南
java
间彧14 小时前
Spring Secutiy基本原理及工作流程
java
Java水解15 小时前
JAVA经典面试题附答案(持续更新版)
java·后端·面试
洛小豆18 小时前
在Java中，Integer.parseInt和Integer.valueOf有什么区别
java·后端·面试
前端小张同学18 小时前
服务器上如何搭建jenkins 服务CI/CD😎😎
java·后端
ytadpole18 小时前
Spring Cloud Gateway：一次不规范 URL 引发的路由转发404问题排查
java·后端
热门推荐
01GitHub 镜像站点02UV 工具安装与国内镜像源配置指南03Claude Code 平替：OpenAI发布 Codex CLI ，GPT-5 国内直接使用04UV安装并设置国内源0546个Nano-banana 精选提示词，持续更新中06保姆级教程：手把手教你用Dify实现完美多轮对话（附Chatflow和提示词）07A股预测还能更准？开源大模型Kronos带你跑通预测+回测全流程08解决 WSL Ubuntu 中 /etc/resolv.conf 自动重置问题09KGG转MP3工具|非KGM文件|解密音频10conda中设置镜像地址（附所有可换的地址）