Flutter中如何将DateTime转换为微软Excel格式的时间戳整数？

嘿，这个问题我之前帮不少开发者解决过，Excel的日期整数其实是有固定规则的，咱们一步步来搞定它！

首先得明确Excel的日期计数逻辑：它把1900年1月1日作为起始点（对应数值1），之后每过一天数值就加1。不过要注意一个历史bug——Excel错误地把1900年当成了闰年，所以如果你的日期在1900年3月1日之前，需要额外修正（不过现在大部分业务场景用不到这么早的日期，还是提一下更稳妥）。

基础转换方法（推荐用UTC时间） #

下面的函数可以把传入的DateTime（建议用UTC时间，避免时区偏差）转换成Excel要求的整数格式：

int dateTimeToExcelTimestamp(DateTime date) {
  // Excel的起始基准日期：1900-01-01 UTC
  final excelEpoch = DateTime.utc(1900, 1, 1);
  // 计算目标日期与基准日期的天数差
  int daysDifference = date.difference(excelEpoch).inDays;
  
  // 修复Excel的1900闰年bug：若日期早于1900-03-01，需减1（因为Excel多算了一天）
  if (date.isBefore(DateTime.utc(1900, 3, 1))) {
    daysDifference -= 1;
  }
  
  // Excel起始值为1，所以最终结果是天数差 + 1
  return daysDifference + 1;
}

处理本地时间的场景 #

如果你的DateTime是本地时间，建议先转换成UTC再计算，避免时区导致的天数偏差：

int localDateTimeToExcelTimestamp(DateTime localDate) {
  return dateTimeToExcelTimestamp(localDate.toUtc());
}

验证示例 #

你可以用这些常见日期测试：

• 1900-01-01 UTC → 返回1（和Excel起始规则一致）
• 2023-01-01 UTC → 返回44927（在Excel中输入这个数值，设置单元格格式为日期会显示2023/1/1）
• 2024-05-20 UTC → 返回45433

额外补充：带时分秒的精确时间戳 #

如果后端需要包含小数的时间戳（比如精确到小时/分钟），可以把时间部分转换成天数的小数部分，加到整数结果里：

double dateTimeToExcelTimestampWithTime(DateTime date) {
  int days = dateTimeToExcelTimestamp(date);
  // 把时分秒转换成一天的占比（一天86400秒）
  double fractionalDay = (date.hour * 3600 + date.minute * 60 + date.second) / 86400;
  return days + fractionalDay;
}

这样就能完美匹配后端要求的44xxx格式整数啦！

内容的提问来源于stack exchange，提问作者Liew Syet Chau