使用XLSX v0.15.6导出Excel时日期字段异常问题求助

使用XLSX v0.15.6将PHP5.6构建的HTML表格导出为Excel时，日期字段出现异常变更。导出逻辑依赖JavaScript及jQuery v1.10.2，运行环境为Ubuntu 20.04和LibreOffice。

表格中的日期与控制台打印值完全一致，但导出后部分日期的格式、数值与原数据不匹配。导出函数代码如下：

function exportExcel() {
        /** 
         * * Filename 
         * */
        var fileName = 'Acc ' + currentDate + '.xls'

        /**
         * * Get the table  
         * */
        const table = document.getElementById('table');

        /**
         ** Clone the table and remove unnecessary celds from de new table
         */
        var cloneTable = table.cloneNode(true);
        jQuery(cloneTable).find('.noPrint').remove();

        /**
         * * Print all date celds for checking 
         * */
        jQuery(cloneTable).find('.date').text(function(i, originalDate) {
            console.log(originalDate)
        })

        /** 
         * * Remove spaces   
         * */
        jQuery(cloneTable).find('td').text(function(i, originalText) {
            const newText = originalText.trim()
            return newText
        })

        /** 
         * * Create the wb
         * */
        const wb = XLSX.utils.table_to_book(cloneTable, {
            sheet: 'Hoja 1'
        });

        /**
         * * Exportar the file 
         * */
        XLSX.writeFile(wb, fileName);
    }

1. XLSX自动类型推断引发日期转义 #

XLSX的table_to_book方法会自动检测单元格内容并推断数据类型，当识别到类似日期的字符串（如YYYY-MM-DD、DD/MM/YYYY）时，会将其转换为Excel内部的数值时间戳（从1900年1月1日起的累计天数）。不同地区的LibreOffice/Excel对时间戳的显示格式解析规则不同，最终导致显示内容和原字符串不符。

解决方法：禁用自动类型推断，强制将日期单元格设为文本类型。可以通过修改table_to_book配置实现：

// 修改table_to_book配置，强制所有单元格按文本处理
const wb = XLSX.utils.table_to_book(cloneTable, {
    sheet: 'Hoja 1',
    cellText: true, // 优先读取单元格文本内容
    cellHTML: false // 不解析HTML结构
});

也可以针对.date类单元格单独设置类型：

// 先将表格转为工作表
const ws = XLSX.utils.table_to_sheet(cloneTable);
// 遍历所有日期单元格，设置为文本类型
jQuery(cloneTable).find('.date').each(function(index, elem) {
    // 获取单元格坐标（行索引从0开始，需+1对应Excel行号）
    const cellAddress = XLSX.utils.encode_cell({
        c: elem.cellIndex,
        r: elem.parentElement.rowIndex
    });
    if(ws[cellAddress]) {
        ws[cellAddress].t = 's'; // 's'代表文本类型
    }
});
// 构建工作簿并导出
const wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, 'Hoja 1');
XLSX.writeFile(wb, fileName);

2. 日期格式的地区歧义问题 #

如果原日期格式是DD/MM/YYYY这类格式，XLSX可能会误判为美式的MM/DD/YYYY格式，导致日期数值错误（比如01/03/2024会被解析为1月3日而非3月1日）。控制台打印的是原始字符串不会出错，但导出后会被解析为错误的日期值。

解决方法：将日期转换为无歧义的ISO标准格式（YYYY-MM-DD）再导出：

// 处理.date单元格，将DD/MM/YYYY转为YYYY-MM-DD
jQuery(cloneTable).find('.date').text(function(i, originalDate) {
    const parts = originalDate.split('/');
    if(parts.length === 3) {
        return `${parts[2]}-${parts[1].padStart(2, '0')}-${parts[0].padStart(2, '0')}`;
    }
    return originalDate;
});

3. LibreOffice自动识别日期干扰 #

即使XLSX导出的是正确的文本日期，LibreOffice打开文件时可能会自动将文本识别为日期并转换格式，导致显示异常。

解决方法：

• 导出时给日期单元格设置文本格式：

const ws = XLSX.utils.table_to_sheet(cloneTable);
Object.keys(ws).forEach(key => {
    if(key.startsWith('!')) return; // 跳过工作表元数据
    const cell = ws[key];
    // 通过单元格坐标找到对应的DOM元素，判断是否为日期单元格
    const cellPos = XLSX.utils.decode_cell(key);
    const rowElem = cloneTable.rows[cellPos.r];
    if(rowElem) {
        const cellElem = rowElem.cells[cellPos.c];
        if(cellElem && cellElem.classList.contains('date')) {
            cell.t = 's';
            cell.z = '@'; // 设置为纯文本格式
        }
    }
});

• 调整LibreOffice设置：打开文件时，在导入向导中选择“文本”类型处理日期列；或者进入LibreOffice选项，关闭“自动识别日期和时间”功能。

4. XLSX版本bug #

v0.15.6是较早的版本，可能存在日期解析的已知bug，升级到较新版本的XLSX（如v0.18.x及以上）可能会直接解决该问题。

内容的提问来源于stack exchange，提问作者Frank Botelle Valdes