C#怎么解析Excel日期_C# NPOI处理自定义格式与1900纪元【避坑】
NPOI处理Excel日期需注意1900/1904双纪元造成1462天偏移。通过workbook.IsDate1904判断纪元，调用DateUtil.GetDateTimeFromExcel传入正确参数。自定义日期格式宜用NumericCellValue获取数值后手动格式化，避免依赖StringCellValue缓存导致错误。
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标志、单元格原始数值的合法性、以及样式是否真正绑定成功。漏掉任意一个，日期就可能无声无息地错掉几年，或者直接变成一串数字。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境，集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境，基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
Xcode 是苹果面向 Mac 提供的官方集成开发环境，将代码编辑、项目构建、SwiftUI 实时预览、设备模拟、自动化测试、断点调试、性能分析和应用分发整合在同一套工作流中，适合开发与维护 iPhone、iPad、Mac、Apple Wa
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
Visual Studio Code 是微软提供的免费代码编辑器，支持 macOS，并为 Intel 与 Apple 芯片 Mac 提供适配版本。软件集代码编辑、调试、Git 源代码管理、集成终端和扩展市场于一体。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
PixPix 是面向品牌、卖家和内容团队的在线 AI 图片视频创作平台，提供图视频 Agent、无限画布、图片生成、视频生成、自然语言编辑及商品套图、产品精修和带货视频等电商工具。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。
Android Studio 是 Google 面向 Android 应用开发提供的官方集成开发环境，以 IntelliJ IDEA 为基础，集成智能代码编辑、Gradle 构建、设备模拟、界面预览、调试测试及性能分析工具，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
Visual Studio Code 是微软推出的免费代码编辑器，Windows 版集成智能补全、代码导航、调试、终端和版本控制，并可通过扩展添加语言、格式化及远程开发能力。它启动较快、配置灵活，
REAPER 是 Cockos 推出的数字音频工作站，适用于录音、MIDI 编曲、音频编辑、混音、母带制作及声音设计。软件安装包小巧，支持多轨录制、灵活路由、自动化、第三方插件和脚本扩展，并提供完整功能的 60 天免费评估期。
Adobe Audition 是面向播客、影视后期、广播与音乐制作的专业音频工作站，提供波形编辑、多轨混音、频谱分析、录音、降噪修复和效果处理等功能。Windows 版通过 Adobe Creative Cloud 安装和管理，
Pro Tools 是 Avid 推出的专业数字音频工作站，提供多轨录音、音频剪辑、MIDI编曲、插件处理、自动化混音及影视声音制作能力。它适合音乐人、录音师、制作人和音频后期团队使用，并提供免费入门版、订阅方案及永久授权选择。