JavaScript导出含动态属性JSON至Excel时，实现Excel自动识别日期字符串为日期类型的解决方案

我太懂你这个困扰了——动态属性的JSON里到处藏着日期字符串，有的是YYYY-MM-DD格式，有的带时分秒，你还没法提前知道哪个字段是日期，用xlsx库导出后Excel全把它们当普通文本，改格式改到崩溃对吧？别慌，我给你准备了两种靠谱的解决方案，覆盖用xlsx库和纯原生JS两种场景，完美贴合你的需求。

一、使用xlsx库的正确姿势（解决你之前的无效问题） #

你之前用xlsx没成功，大概率是没配置对日期检测和单元格格式的参数。xlsx其实支持自动识别日期并设置Excel的日期类型，关键是要先遍历所有数据，检测出符合格式的日期字符串，再给对应的单元格设置类型和显示格式，这样既保留原日期的显示内容，又能让Excel把它当成日期对象处理。

步骤1：写一个日期字符串检测函数 #

先搞定核心的日期检测，要同时支持两种格式：

function isDateString(value) {
  if (typeof value !== 'string') return false;
  // 匹配YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS格式
  const dateRegex = /^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}:\d{2})?$/;
  if (!dateRegex.test(value)) return false;
  // 验证日期的合法性，比如2020-02-30这种无效日期要排除
  const dateObj = new Date(value);
  return dateObj instanceof Date && !isNaN(dateObj);
}

步骤2：处理JSON数据，转换为xlsx可识别的单元格结构 #

遍历你的JSON数组，把每个对象的键值对转换成xlsx的单元格数组，对识别出的日期字符串，设置单元格类型为'd'（日期类型），并配置对应的显示格式z，确保原格式不变：

function processJsonForXlsx(jsonData) {
  // 提取所有动态表头
  const headers = [...new Set(jsonData.flatMap(obj => Object.keys(obj)))];
  // 处理表头行
  const headerRow = headers.map(header => ({ v: header, t: 's' }));
  // 处理数据行
  const dataRows = jsonData.map(rowObj => {
    return headers.map(header => {
      const value = rowObj[header] ?? '';
      if (isDateString(value)) {
        // 根据是否带时分秒设置对应的Excel显示格式
        const format = value.includes(' ') ? 'yyyy-mm-dd hh:mm:ss' : 'yyyy-mm-dd';
        return {
          v: new Date(value), // 转成Date对象供xlsx识别
          t: 'd', // 单元格类型为日期
          z: format // 保留原显示格式
        };
      }
      return { v: value, t: typeof value === 'number' ? 'n' : 's' };
    });
  });
  // 组合成完整的工作表数据
  return [headerRow, ...dataRows];
}

步骤3：生成并下载Excel文件 #

最后调用xlsx的API生成文件，配置好参数：

import * as XLSX from 'xlsx';

// 示例JSON数据
const sampleData = [
  { id: 1, name: "JoJo", createTime: "2020-03-13", updateTime: "2020-03-13 14:30:00" },
  { id: 2, name: "Dio", createTime: "2002-10-15", updateTime: "2002-10-15 13:10:10" }
];

// 处理数据
const wsData = processJsonForXlsx(sampleData);
// 创建工作表
const ws = XLSX.utils.aoa_to_sheet(wsData);
// 创建工作簿并添加工作表
const wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, "Data");
// 下载文件
XLSX.writeFile(wb, "data.xlsx");

这样导出的Excel里，日期字符串会被自动识别为日期类型，而且完全保留原有的显示格式，带时分秒的不会被截断，不带的也不会补时间。

二、纯原生JS方案（无需任何库） #

如果你不想依赖第三方库，那可以用生成HTML表格再导出为Excel的方法——Excel对HTML表格里的标准日期字符串识别度很高，只要我们把日期字符串正确放入表格单元格，导出后Excel会自动把它们当成日期对象。

完整代码示例 #

function isDateString(value) {
  if (typeof value !== 'string') return false;
  const dateRegex = /^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}:\d{2})?$/;
  if (!dateRegex.test(value)) return false;
  const dateObj = new Date(value);
  return dateObj instanceof Date && !isNaN(dateObj);
}

function exportJsonToExcel(jsonData, fileName = "data.xlsx") {
  // 提取所有表头
  const headers = [...new Set(jsonData.flatMap(obj => Object.keys(obj)))];
  // 创建表格HTML
  let tableHtml = '<table><thead><tr>';
  // 表头行
  headers.forEach(header => {
    tableHtml += `<th>${header}</th>`;
  });
  tableHtml += '</tr></thead><tbody>';
  // 数据行
  jsonData.forEach(rowObj => {
    tableHtml += '<tr>';
    headers.forEach(header => {
      const value = rowObj[header] ?? '';
      // 对日期字符串，我们不需要修改内容，直接放入单元格即可，Excel会自动识别
      tableHtml += `<td>${value}</td>`;
    });
    tableHtml += '</tr>';
  });
  tableHtml += '</tbody></table>';
  
  // 创建Blob对象
  const blob = new Blob([tableHtml], {
    type: 'application/vnd.ms-excel;charset=utf-8'
  });
  // 创建下载链接
  const url = URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = fileName;
  document.body.appendChild(a);
  a.click();
  // 清理资源
  document.body.removeChild(a);
  URL.revokeObjectURL(url);
}

// 示例调用
const sampleData = [
  { id: 1, name: "JoJo", createTime: "2020-03-13", updateTime: "2020-03-13 14:30:00" },
  { id: 2, name: "Dio", createTime: "2002-10-15", updateTime: "2002-10-15 13:10:10" }
];
exportJsonToExcel(sampleData);

这个方案的核心是：Excel原生支持识别标准ISO格式的日期字符串，只要我们把内容正确放入HTML表格再导出，Excel打开时会自动把这些字符串解析成日期类型，同时完全保留原有的显示格式，完美符合你的两个要求——不用提前知道哪个字段是日期，也不会修改日期的内容。

为什么你之前的TSV转Excel失败了？ #

你之前直接把TSV文件改后缀成xlsx肯定不行，因为xlsx是二进制的压缩格式，不是纯文本，TSV是纯文本，直接改后缀Excel会识别为损坏的文件。而用HTML表格转Excel的方法，是利用了Excel能直接解析HTML表格的特性，这个是官方支持的，所以不会出现打不开的问题。

备注：内容来源于stack exchange，提问作者JoJo