ExcelJS生成Excel时HH:MM列未被识别，无法求和如何解决？

在使用ExcelJS生成Excel时，给某列单元格设置[h]:mm格式后，生成的文件中该列初始显示为文本样式，无法对时长求和（仅能统计单元格数量）；手动选中单元格后才会被识别为时间格式。尝试用Date对象赋值给单元格，Excel能识别为日期类型，但自动求和功能异常。

相关代码 #

worksheet1.getColumn(5).eachCell({ includeEmpty: false }, function(cell, rowNumber) {
    if(rowNumber > 1) {
        cell.style = {
            numRmt: "[h]:mm" // 注意此处属性名存在笔误
        };
    }
});
worksheet1.autoFilter = {
    from: { row: 1, column: 1 },
    to: { row: 1, column: 7 }
};

现象说明 #

• 初始显示状态：单元格内容显示为类似01:30的文本，Excel状态栏仅显示单元格计数，无求和结果。
• 手动选中后状态：单元格被识别为时间格式，状态栏显示正确的时长求和结果。

解决方法 #

1. 修正格式属性名的笔误 #

ExcelJS中设置数字格式的正确属性名是numFmt，而非代码中的numRmt，这是导致格式不生效的基础问题：

cell.style = {
    numFmt: "[h]:mm"
};

2. 确保单元格值为Excel可识别的时间数值 #

Excel的时间/时长本质是小数数值（1天=1，1小时=1/24，1分钟=1/(24*60)）。如果单元格值是字符串（如"01:30"），即使设置格式，Excel仍会将其视为文本，无法参与求和。

针对时长的正确赋值逻辑：

将hh:mm格式的字符串转换为对应小数数值，再赋值给单元格：

worksheet1.getColumn(5).eachCell({ includeEmpty: false }, function(cell, rowNumber) {
    if(rowNumber > 1) {
        // 假设单元格原数据是"hh:mm"格式的字符串
        const timeStr = cell.value;
        const [hours, minutes] = timeStr.split(":").map(Number);
        // 转换为Excel可识别的时长数值
        const timeValue = (hours + minutes / 60) / 24;
        
        cell.value = timeValue;
        cell.style = { numFmt: "[h]:mm" };
    }
});

3. 高效批量设置列格式 #

可以直接为整列设置格式，再批量赋值，提升代码效率：

// 先给第5列统一设置时长格式
worksheet1.getColumn(5).numFmt = "[h]:mm";

// 遍历单元格赋值
worksheet1.getColumn(5).eachCell({ includeEmpty: false }, function(cell, rowNumber) {
    if(rowNumber > 1) {
        const timeStr = cell.value;
        const [hours, minutes] = timeStr.split(":").map(Number);
        cell.value = (hours + minutes / 60) / 24;
    }
});

关于Date对象求和异常的原因 #

Date对象包含完整的日期+时间信息，Excel会将其视为日期时间戳（从1900年1月1日开始的累计天数）。当对多个Date对象求和时，Excel会计算日期时间戳的总和，而非单纯的时长相加（例如不同日期的时间求和会包含天数差），因此处理时长场景时，直接使用小数数值是更准确的方案。

内容的提问来源于stack exchange，提问作者Lucas M. N. Xavier