Swift中伊斯兰日历Date()计算出现不合逻辑的时间结果问题

在Swift中使用默认伊斯兰日历（.islamic）处理月末日期的时间增量时，会出现不符合预期的跳月问题：

• 给定伊斯兰历1445年7月29日20:00，添加5小时后得到7月30日01:00（符合预期）
• 但添加6小时后却直接跳到8月1日02:00，完全不符合逻辑
  该问题在公历（.gregorian）中不会复现。

问题代码示例 #

import SwiftUI

let calendar = Calendar(identifier: .islamic)
let formatter = DateFormatter()
formatter.calendar = calendar
formatter.dateFormat = "dd/MM/yyyy HH:mma"

let components = DateComponents(calendar: calendar, year: 1445, month: 7, day: 29, hour: 20, minute: 0, second: 0)
let givenDate = calendar.date(from: components)!
let after_5_hours = givenDate.advanced(by: 60 * 60 * 5)
let after_6_hours = givenDate.advanced(by: 60 * 60 * 6)

formatter.string(from: givenDate)      // = "29/07/1445 20:00PM"
formatter.string(from: after_5_hours)  // = "30/07/1445 01:00AM"
formatter.string(from: after_6_hours)  // = "01/08/1445 02:00AM"

问题原因 #

1. 伊斯兰日历的特殊性：伊斯兰历是阴历，月份天数为29或30天，且默认的.islamic日历算法存在模糊性，对部分月份的天数判定不准确；部分伊斯兰历变体的日期切换以日落为节点（而非公历的午夜），进一步加剧了时间计算的偏差。
2. advanced(by:)的局限性：该方法基于绝对时间戳的秒数增量计算，未遵循目标日历的日期规则，当遇到日历中不存在的日期（比如实际只有29天的月份却计算出30日）时，系统会自动修正到下一个有效日期，导致跳月。

解决方案 #

方案1：使用标准化的乌姆古拉历（沙特官方伊斯兰历）

替换默认的伊斯兰日历为.islamicUmmAlQura，该日历是标准化的官方实现，日期天数判定更准确：

// 替换日历初始化代码
let calendar = Calendar(identifier: .islamicUmmAlQura)

方案2：使用日历组件增量方法替代绝对时间增量

避免使用advanced(by:)，改用Calendar提供的组件增量方法，严格遵循目标日历的规则计算：

// 替代原有的advanced(by:)写法
let after5Hours = calendar.date(byAdding: .hour, value: 5, to: givenDate)
let after6Hours = calendar.date(byAdding: .hour, value: 6, to: givenDate)

这种方式会直接按照伊斯兰日历的规则计算时间增量，不会出现无效日期导致的跳月问题。

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