使用Intl.DateTimeFormat转换公历至回历出现日期差一天问题

问题原因 #

这不是Intl.DateTimeFormat的bug，而是时区偏移导致的日期计算错位。JavaScript的Date对象默认基于本地时区创建，而伊斯兰历的日期转换通常以UTC时间为基准。例如，当你用new Date(2024, 2, 22)创建日期时，若你的本地时区是UTC+5（巴基斯坦时区），这个日期对应的UTC时间是2024-03-21T19:00:00Z，此时Intl会基于UTC的21号计算回历日期，自然比预期的22号（对应回历斋月11日）超前一天。

解决方法 #

通过两个关键调整修正时区问题：

1. 用Date.UTC()构造UTC基准的日期对象
2. 在Intl.DateTimeFormat选项中指定timeZone: 'UTC'

修改后的代码：

console.log(new Intl.DateTimeFormat(
  'en-PK-u-ca-islamic-umalqura', {
    day: 'numeric',
    month: 'long',
    weekday: 'long',
    year: 'numeric',
    timeZone: 'UTC' // 强制使用UTC时区计算
  }).format(new Date(Date.UTC(2024, 2, 22)))); // 构造UTC时间的2024年3月22日

这段代码会输出正确的回历日期：Friday, Ramadan 11, 1445，对应公历2024年3月22日。

补充说明 #

• 优先使用islamic-umalqura日历类型，这是沙特官方使用的回历标准，日期准确性更高
• 无论切换哪个地区设置，时区处理都是核心问题，必须确保日期计算基于UTC基准

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