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

必读信息

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

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

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

hutool 官方文档地址：https://hutool.cn/docs
hutool API 文档地址：https://apidoc.gitee.com/dromara/hutool

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

gradle 项目

// 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 项目

<!-- 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%E7%94%9F%E6%88%90-ExcelWriter

List 生成表格数据

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

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

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

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 中添加数据。有两个需要注意的地方：

表格的表头会按照数组中第一个 Map 的 key 生成，比如说：我在第二个 Map 中存在一个 key 为性别的值，但第一个 Map 中并没有性别 key，那么生成的表格中将不会有性别这一列，生成的表头只以数组的第一个 Map 的 key 生成。
这种方式生成的表格，列的顺序是没法控制的。

// 生成一个新的 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，主要注意以下两点：

生成列的顺序和定义实体字段的顺序一致。
@Alias() 注解可以用于设置实体属性与列的别名，如果没有设置那么列名为实体的属性名称。除此之外，还可以通过方法 writer.addHeaderAlias(实体字段名称, 字段别名) 来灵活设置别名。

// 自定的实体对象
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;
    }
}

// 生成一个新的 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 开始

// 生成一个新的 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() 完全不起效果。

案例代码：

// 指定默认的行高
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() 方法写入的数据不属于表头。

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

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

// 获得表头单元格样式对象
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);

效果如下：

设置全局样式

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

// 设置前景色（下面两个语句）
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() 方法，那么行单元格中存在数据的单元格的样式会被替换，也就是有内容的单元格样式不会有效果。【这里也巨坑】

案例代码：

// 获得第二行的样式
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 开始。

// 获得第二列的样式
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);

效果如下：

指定单元格样式

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

// 获得第二行第二列的样式
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 中可以认为存在以下几种类型：

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

整数

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

// 创建 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 的数值。

// 创建 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();

效果如下：

序列/下拉

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

// 创建 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();

效果如下：

日期

如下案例：

// 创建 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)

时间

案例如下：

// 创建 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)

文本长度

案例如下：

// 创建 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();

效果如下：

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

文章出处登录后可见！

已经登录？立即刷新

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

必读信息

生成表格

List 生成表格数据

Map 生成表格数据

实体类生成表格数据

指定单元格生成数据

修改单元格样式

行高和列宽

表头样式

设置全局样式

设置行样式

设置列样式

指定单元格样式

设置数据有效性

整数

小数

序列/下拉

日期

时间

文本长度

相关推荐