KMP项目iOS端日期时间解析纳秒存在舍入误差问题

问题原因 #

NSDate内部用Double类型存储时间戳，而Double的浮点精度无法精确表示所有毫秒对应的纳秒值。解析hh:mm:ss.SSS a格式字符串时，部分毫秒值会被转换成接近但略有偏差的纳秒数（比如456ms变成455999970ns），直接截断取整就会导致毫秒值少1。

解决方案 #

方案1：对纳秒值四舍五入到毫秒 #

不用直接截断，通过四舍五入计算毫秒值，抵消微小精度偏差：

// 替换原代码中直接除法的逻辑
val millisecond = Math.round(nanosecond / 1_000_000.0).toInt()

哪怕纳秒值是455999970，四舍五入后也会得到预期的456。

方案2：直接从字符串提取毫秒部分 #

既然时间字符串明确包含.SSS格式的毫秒段，直接拆分字符串提取这部分值，完全绕过NSDate的精度问题：

actual fun fromString(stringValue: String): DateTest {
    // 提取毫秒部分
    val millisecond = run {
        val dotIndex = stringValue.indexOf('.')
        if (dotIndex != -1) {
            // 找到毫秒段的结束位置（空格或字符串末尾）
            val endIndex = stringValue.indexOf(' ', dotIndex).takeIf { it != -1 } ?: stringValue.length
            // 处理毫秒段不足3位的情况，补0后取前3位
            val msStr = stringValue.substring(dotIndex + 1, endIndex).padEnd(3, '0').take(3)
            msStr.toIntOrNull() ?: 0
        } else {
            0
        }
    }

    // 解析其他时间字段（这部分精度无问题）
    dateFormat.dateFromString(stringValue)?.let { nsDate ->
        val nsCalendar = NSCalendar.currentCalendar
        val year = nsCalendar.component(NSCalendarUnitYear, nsDate).toInt()
        val month = nsCalendar.component(NSCalendarUnitMonth, nsDate).toInt()
        val day = nsCalendar.component(NSCalendarUnitDay, nsDate).toInt()
        val hour = nsCalendar.component(NSCalendarUnitHour, nsDate).toInt()
        val minute = nsCalendar.component(NSCalendarUnitMinute, nsDate).toInt()
        val second = nsCalendar.component(NSCalendarUnitSecond, nsDate).toInt()
        
        return DateTest(year, month, day, hour, minute, second, millisecond)
    }
    return DateTest()
}

这种方法完全依赖字符串结构获取毫秒值，不受NSDate浮点精度影响，适合对精度要求极高的场景。

方案3：使用更精确的日期解析API（iOS 10+） #

如果项目仅支持iOS 10及以上版本，可尝试ISO8601DateFormatter（适配ISO规范格式）或iOS 15+的DateFormatter.formatContext属性提升解析精度，但对于hh:mm:ss.SSS a这类非ISO格式，方案1或2更直接高效。

总结 #

• 方案1实现成本最低，仅需修改一行代码，能解决绝大多数场景的偏差问题；
• 方案2最可靠，完全避免浮点精度问题，但需要处理字符串边界情况（比如毫秒段不足三位、无空格分隔AM/PM等）。

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