如何为Date类型添加浮点型/双精度天数？

当需要给Date添加非整数天数（比如0.5天）时，直接使用Calendar的date(byAdding:)方法会失败——因为该方法的value参数以及DateComponents的相关字段都只支持Int类型，无法传入浮点数值。

比如这段代码无法正常运行：

let days: Double = 0.5
let date = Calendar.current.date(byAdding: .day, value: days, to: Date())

对应的API定义也能看出明确限制：

public func date(byAdding components: DateComponents, to date: Date, wrappingComponents: Bool = false) -> Date?
public func date(byAdding component: Calendar.Component, value: Int, to date: Date, wrappingComponents: Bool = false) -> Date?

public struct DateComponents : ReferenceConvertible, Hashable, Equatable, Sendable {
    // ...
    public init(calendar: Calendar? = nil, timeZone: TimeZone? = nil, era: Int? = nil, year: Int? = nil, month: Int? = nil, day: Int? = nil, hour: Int? = nil, minute: Int? = nil, second: Int? = nil, nanosecond: Int? = nil, weekday: Int? = nil, weekdayOrdinal: Int? = nil, quarter: Int? = nil, weekOfMonth: Int? = nil, weekOfYear: Int? = nil, yearForWeekOfYear: Int? = nil)
    // ...
}

解决方案 #

可以通过两种方式实现需求：

1. 直接转换为时间间隔添加

将浮点天数转换为秒数（1天=86400秒），使用Date的addingTimeInterval(_:)方法：

let days: Double = 0.5
let targetDate = Date().addingTimeInterval(days * 86400)

这种方式简单高效，适合不需要考虑夏令时、闰秒等日历特殊规则的场景。

2. 拆分整数与小数部分（更贴合日历逻辑）

如果需要严格遵循日历规则（比如应对夏令时切换导致一天时长不等于86400秒的情况），可以先添加整数天数，再处理小数部分对应的时间：

let days: Double = 2.5
let integerDays = Int(days)
let fractionalDays = days - Double(integerDays)

// 先通过Calendar添加整数天数
guard var targetDate = Calendar.current.date(byAdding: .day, value: integerDays, to: Date()) else {
    // 处理日期计算失败的情况
    fatalError("日期计算失败")
}

// 将小数部分转换为秒数添加
targetDate = targetDate.addingTimeInterval(fractionalDays * 86400)

这种方法先利用Calendar处理整数天数的日历逻辑，再补充小数部分的绝对时间，兼顾了准确性和日历规则。

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