Kotlin计算yyyy-MM-dd格式日期与当前日期的时间间隔（Android API24）

你之前的代码实现存在一个认知偏差：无参调用Calendar.getInstance()初始化得到的对象，默认就携带设备当前的系统时间，不需要额外执行赋值操作。你当前的卡点本质是把这个代表当前时间的Calendar实例，直接赋值成了字符串解析出来的历史日期，导致两个被比对的对象混成了同一个，失去了独立的当前时间参照。

• 拆分成两个独立的Calendar实例，分别存储目标历史日期、当前系统时间，不要共用同一个对象
• 因为你的输入字符串只精确到天，需要把两个Calendar的时分秒毫秒全部清零，消除非天级别的时间差带来的计算误差

对应的可运行代码示例：

// 初始化日期解析器，绑定默认Locale避免不同系统语言/时区下的解析偏差
val dateFormat = SimpleDateFormat("yyyy-MM-dd", Locale.getDefault())

// 第一个实例：存储解析后的目标历史日期
val targetDate = Calendar.getInstance().apply {
    time = dateFormat.parse("2001-06-04")
    // 清零时分秒毫秒，对齐到当天零点
    set(Calendar.HOUR_OF_DAY, 0)
    set(Calendar.MINUTE, 0)
    set(Calendar.SECOND, 0)
    set(Calendar.MILLISECOND, 0)
}

// 第二个实例：这就是天然代表当前时间的Calendar对象，不需要额外赋值
val nowDate = Calendar.getInstance().apply {
    // 同样对齐到当天零点，消除非天级别的时间差影响
    set(Calendar.HOUR_OF_DAY, 0)
    set(Calendar.MINUTE, 0)
    set(Calendar.SECOND, 0)
    set(Calendar.MILLISECOND, 0)
}

直接拿毫秒差值除以固定常量算年/月/日，会存在大小月、闰年、夏令时切换的计算误差，需要按日历字段逐次做借位计算，才能得到和输入格式（年-月-日）匹配的拆分结果：

// 初始化差值变量
var yearGap = nowDate.get(Calendar.YEAR) - targetDate.get(Calendar.YEAR)
var monthGap = nowDate.get(Calendar.MONTH) - targetDate.get(Calendar.MONTH)
var dayGap = nowDate.get(Calendar.DAY_OF_MONTH) - targetDate.get(Calendar.DAY_OF_MONTH)

// 日差为负时，从上月借位补全天数
if (dayGap < 0) {
    monthGap -= 1
    // 获取目标所在月份的最大自然天数，补到日差值里
    val lastMonthMaxDay = nowDate.getActualMaximum(Calendar.DAY_OF_MONTH)
    dayGap += lastMonthMaxDay
}
// 月差为负时，从年差借位补全月份
if (monthGap < 0) {
    yearGap -= 1
    monthGap += 12
}

// 最终输出和输入格式匹配的拆分结果
val durationResult = "$yearGap 年 $monthGap 月 $dayGap 天"

• 不要省略时分秒清零的步骤：如果不对齐到当天零点，会出现“距离目标日期还有3小时满1天，计算结果就提前算成1天”的偏差
• 不要直接用毫秒值除以24小时的常量算天数：遇到夏令时切换、系统时区调整的场景，部分自然天的时长不足24小时，直接换算会出现计算错误
• 适配提示：针对Android API 24的版本，因为没有原生java.time日期类的支持，如果觉得Calendar的借位逻辑繁琐，可以引入官方兼容库ThreeTenABP，直接用LocalDate类的内置方法计算日期间隔，不需要手写借位逻辑，兼容低版本系统。

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