C#使用PersianCalendar转换波斯历1400年日期为DateTime时的异常解决方法

异常根因 #

你遇到的报错完全来自.NET早期版本内置PersianCalendar类的两个已知问题：

1. 年份范围校验存在硬编码错误
   从异常信息可以看到，类内置的支持范围被错误截断到了公历1999年12月31日（也就是异常里的99/12/31），对应波斯历的最大支持年份仅为1378年，完全无法覆盖2000年之后的公历日期，自然不支持你传入的波斯历1400年的参数，直接触发year > MaxCalendarYear的校验分支抛出异常。日志里显示Actual value was 0是异常信息输出逻辑的bug，不代表你传入的参数真的是0。
2. 常见使用方式错误
   不少开发者会直接把波斯历的年月日传给DateTime的构造函数，该构造函数默认使用公历规则做参数校验，完全不会关联PersianCalendar的转换逻辑，也会触发同类范围校验异常。

具体修复方案 #

• 升级运行时版本
  如果你使用的是.NET Framework、.NET Core 3.1及更早版本，优先升级到.NET 6及以上的现代运行时。新版运行时已经修复了PersianCalendar的范围截断bug，完整支持波斯历1年到9378年的转换，支持的公历范围覆盖到公元9999年12月31日，不会再出现把上限错误截断到1999年的问题。
• 使用正确的转换API
  不要直接向DateTime构造函数传入波斯历参数，正确的转换逻辑需要通过PersianCalendar实例提供的方法完成，示例代码：

  // 实例化波斯历对象
  PersianCalendar persianCalendar = new PersianCalendar();
  // 调用类内置的方法，传入波斯历1400年1月1日的参数，直接生成对应的标准DateTime
  DateTime targetDate = persianCalendar.ToDateTime(
      year: 1400, 
      month: 1, 
      day: 1, 
      hour: 0, 
      minute: 0, 
      second: 0, 
      millisecond: 0
  );
  

• 无法升级运行时的兼容方案
  如果项目因依赖限制无法升级.NET版本，不要使用内置的PersianCalendar类做转换，可以手动实现波斯历与公历的换算逻辑，绕开类内置的错误年份范围校验。

内容的提问来源于stack exchange，提问作者mr.313