使用ExcelJS导出JavaScript Date对象时时间显示异常求助

原因 #

JavaScript的Date对象本质是基于UTC的时间戳（存储从1970-01-01 UTC起的毫秒数），ExcelJS在处理Date对象时，默认会直接读取这个UTC时间戳并转换为Excel的日期序列号，因此导出后会显示为UTC时间，而非原本地时间。

解决方法 #

方法1：手动构建本地时间的UTC对象 #

提取原Date的本地时间字段（年、月、日、时、分、秒），用Date.UTC()构建一个新的Date对象，将这个对象传给ExcelJS，相当于把本地时间“伪装”成UTC时间存入Excel，从而保留原本地时间显示：

const originalDate = new Date("Wed Mar 01 2023 12:54:19 GMT-0500 (Eastern Standard Time)");

// 提取本地时间各部分
const localYear = originalDate.getFullYear();
const localMonth = originalDate.getMonth();
const localDate = originalDate.getDate();
const localHours = originalDate.getHours();
const localMinutes = originalDate.getMinutes();
const localSeconds = originalDate.getSeconds();

// 构建以本地时间为UTC的Date对象
const localTimeAsUTC = new Date(Date.UTC(localYear, localMonth, localDate, localHours, localMinutes, localSeconds));

// 写入Excel
worksheet.getCell('A1').value = localTimeAsUTC;
// 设置日期格式（可选）
worksheet.getCell('A1').numFmt = 'm/d/yyyy h:mm:ss AM/PM';

方法2：直接计算Excel本地日期序列号 #

Excel的日期是从1900-01-01开始的序列号（1代表1900-01-01），手动计算本地时间对应的序列号并传入ExcelJS：

function getLocalExcelSerial(date) {
  // 创建仅包含本地时间的Date对象
  const localDate = new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds());
  const excelEpoch = new Date(1900, 0, 1);
  let daysDiff = (localDate - excelEpoch) / (1000 * 60 * 60 * 24);
  
  // 处理Excel的1900闰年bug（Excel错误认为1900是闰年）
  if (localDate >= new Date(1900, 2, 1)) {
    daysDiff += 1;
  }
  
  return daysDiff + 1; // Excel中1900-01-01对应序列号1
}

// 使用示例
const originalDate = new Date("Wed Mar 01 2023 12:54:19 GMT-0500 (Eastern Standard Time)");
worksheet.getCell('A1').value = {
  type: 'date',
  value: getLocalExcelSerial(originalDate)
};
worksheet.getCell('A1').numFmt = 'm/d/yyyy h:mm:ss AM/PM';

方法3：写入格式化日期字符串（适合无需计算的场景） #

将本地时间格式化为字符串写入Excel，再设置单元格为日期格式：

const originalDate = new Date("Wed Mar 01 2023 12:54:19 GMT-0500 (Eastern Standard Time)");
// 自定义本地时间格式
const localDateStr = `${originalDate.getMonth()+1}/${originalDate.getDate()}/${originalDate.getFullYear()} ${originalDate.getHours()}:${originalDate.getMinutes()}:${originalDate.getSeconds()}`;

worksheet.getCell('A1').value = localDateStr;
worksheet.getCell('A1').numFmt = 'm/d/yyyy h:mm:ss AM/PM';

内容的提问来源于stack exchange，提问作者Patrick