C#怎么解析Excel日期_C# NPOI处理自定义格式与1900纪元【避坑】

处理Excel日期问题，NPOI本身并不复杂，但真正让人头疼的往往是那些藏在细节里的“世纪陷阱”。比如，你明明读取了一个正常的日期，结果拿到手却是“1900-1-0”或“1899-12-31”——别急着怀疑API，先检查工作簿是否启用了1904日期系统（Mac旧版遗留问题）。一旦启用，日期会整体偏移1462天，必须手动校正。这里的关键是：永远不要直接相信`cell.DateCellValue`，而是先通过`workbook.IsDate1904`确认纪元，再用`DateUtil.GetDateTimeFromExcel`传入正确的`is1904`参数。

Excel日期在NPOI里为什么总是错成1900-1-0？

原因其实很直接：NPOI默认按照Excel的1900纪元（1900年1月1日为第1天）来解析日期，但Excel在不同平台存在两个纪元标准——Windows用1900，Mac旧版用1904。而NPOI并不自动识别工作簿的BaseDate。如果你读取的Excel文件是从Mac另存而来，或者文件本身勾选了“1904日期系统”，那么直接用cell.DateCellValue就会产生1462天（约4年）的偏移，结果表现为“1900-1-0”或“1899-12-31”这类非法值。

那该怎么处理？

• 第一步，先检查工作簿的纪元标志：workbook.IsDate1904——返回true说明是1904纪元，需要手动校正。
• 第二步，不要看到cell.CellType == CellType.Numeric就直接调cell.DateCellValue。先用cell.GetCellType()确认类型，对于由公式生成的日期，还得结合cell.CachedFormulaResultType判断。
• 第三步，遇到疑似日期的数值型单元格，最稳妥的做法是拿到原始double值，然后根据纪元手动转换：

double raw = cell.NumericCellValue;
DateTime dt = workbook.IsDate1904 
    ? DateUtil.GetDateTimeFromExcel(raw, true)  // true表示1904 base
    : DateUtil.GetDateTimeFromExcel(raw, false);

NPOI读自定义日期格式（如“yyyy年MM月dd日”）会丢格式？

确实会。这里的坑在于：cell.StringCellValue返回的是Excel引擎已经计算并缓存的显示值，但这个缓存只在文件被Excel重新计算后才存在。如果Excel文件是程序生成、从未打开重算过，或者单元格虽然设置了自定义格式但值仍为纯数字（比如输入2023/5/20后设格式为“yyyy年MM月dd日”），那么StringCellValue可能会返回空字符串，甚至直接返回原始数字。

怎么避开这个坑？

• 首选方案：走数值路径。用cell.NumericCellValue配合DateUtil.GetDateTimeFromExcel(...)拿到DateTime对象，然后在C#侧自己格式化：dt.ToString("yyyy年MM月dd日")。这样做完全不受Excel缓存影响。
• 如果确实需要依赖Excel端已有的格式，那就得确保源文件已触发重算（比如提前用Excel打开保存一次）。也可以尝试读取cell.CellStyle.DataFormatString来获取格式字符串——注意这个字符串是Excel内部编码（比如"yyyy"m"月"dd"日"），无法直接传给C#的ToString()，需要手动映射。
• 一个常见的错误操作：试图用cell.RichStringCellValue.ToString()来“绕过”。实际上它和StringCellValue底层共享同一缓存，并不会带来额外信息。

为什么DateUtil.GetDateTimeFromExcel返回null或异常？

这个问题通常由三种情况引发：数值超出Excel日期范围（合法值区间为0 <= value <= 2958465）、传入了非日期的数值（如纯百分比、科学计数）、或者数值本身是Excel的错误码（比如Double.NaN或Double.PositiveInfinity）。

每次调用前都必须做范围校验，这是防止异常的最直接方式：

double v = cell.NumericCellValue;
if (double.IsNaN(v) || v < 0 || v > 2958465) {
    // 跳过或记录为无效日期
}

另外，千万别假设所有Numeric类型的单元格都是日期——Excel里时间、百分比、普通数字都存为double。判断它到底是不是日期，需要结合cell.CellStyle.DataFormat。比如DataFormat == 14大概率是短日期，22是带时间的，但如果是自定义格式，该值可能为0甚至负数，这时就需要更多上下文来判断。

如果你遇到了InvalidOperationException，多半是因为传入了0且is1904参数与实际工作簿不符。务必核对workbook.IsDate1904的值。

用NPOI写入日期时，为什么Excel打开显示为数字？

这个问题的根源非常简单：你只调用了cell.SetCellValue(DateTime.Now)，但没有给单元格指定样式。NPOI不会自动套用“日期格式”，所以Excel默认以“常规”格式显示，结果自然是序列号（比如45123）。

要解决它，必须显式创建并绑定CellStyle：

ICellStyle dateStyle = workbook.CreateCellStyle();
IDateFormat df = workbook.CreateDataFormat();
dateStyle.DataFormat = df.GetFormat("yyyy-mm-dd");
cell.CellStyle = dateStyle;
cell.SetCellValue(DateTime.Now);

这里有一个容易忽略的点：格式字符串必须用Excel认可的格式，而不是C#的格式。"yyyy-mm-dd"、"h:mm:ss AM/PM"这类标准格式没问题，但像"yyyy年MM月dd日"在部分NPOI版本中可能不生效。建议先用Excel手动验证这个格式是否被识别。

如果写入后Excel仍然显示数字，右键点击单元格→“设置单元格格式”，在“数字”选项卡里看看是否显示为“自定义”。如果是，说明样式其实已经生效，只是当前视图缩放或列宽不足导致没有全部渲染——这属于Excel的显示问题，与NPOI无关。

总结一下：NPOI处理Excel日期最麻烦的从来不是API调用，而是得同时盯住三个地方——工作簿的IsDate1904标志、单元格原始数值的合法性、以及样式是否真正绑定成功。漏掉任意一个，日期就可能无声无息地错掉几年，或者直接变成一串数字。