Java8如何计算UTC日期剩余天数并按规则展示天/时分秒倒计时

1. 剩余2天未正确展示的原因 #

• 天数计算逻辑存在多处错误：
  • TimeUnit.DAYS.convert(diff, TimeUnit.MILLISECONDS)是向下取整，只有剩余时间满*完整2天（48小时）*才会返回2，如果你期望只要跨2个自然日就算2天需要调整计算逻辑
  • else分支代码完全错误：TimeUnit.DAYS.convert(diff, TimeUnit.SECONDS)是将毫秒差先转秒再转天，返回结果永远是0，无法拿到时分秒需要的时间基数
  • 字符串拼接多了冗余右大括号："$daysRemaining days}"会输出错误格式
  • 混用多种时间类导致时区偏差：服务器返回的是UTC时间，你同时用Joda DateTime、Java Date、Java LocalDateTime，LocalDateTime.now()取的是系统默认时区时间，转UTC时间戳时会出现时区偏移，导致时间差计算错误

2. 秒数异常的原因 #

• 单位不匹配：你调用Duration.ofSeconds(it)时，传入的it大概率是毫秒值，相当于把毫秒数当成秒数传入，总秒数会是实际值的1000倍，模60计算后就会出现超过59的秒数
• 未做范围兜底：没有对剩余时间做非负校验，过期后时间差为负，取模计算也会出现异常值

Java 8自带的java.time包已经完全覆盖Joda Time的能力，官方也推荐优先使用原生java.time实现，避免多套时间类混用导致的时区、单位问题。

核心实现代码（Kotlin） #

import java.time.Instant
import java.util.concurrent.TimeUnit

// 第一步：提前解析服务器返回的UTC有效期，全局只需要解析一次
val endValidityInstant = Instant.parse(uiState.endValidityDate) // 直接解析"2021-11-18T22:59:59Z"格式的字符串

// 第二步：倒计时每秒更新逻辑，统一用毫秒计算，避免单位偏差
fun updateCountdown() {
    val remainingMs = endValidityInstant.toEpochMilli() - Instant.now().toEpochMilli()
    // 已过期兜底
    if (remainingMs <= 0) {
        binding.myTextView.text = "已过期"
        return
    }
    val daysRemaining = TimeUnit.MILLISECONDS.toDays(remainingMs)
    if (daysRemaining > 1) {
        // 剩余大于1天展示天数
        binding.myTextView.text = "$daysRemaining days remaining"
    } else {
        // 剩余小于等于1天展示时分秒，无需前导零，满足1-2位数字要求
        val totalSeconds = TimeUnit.MILLISECONDS.toSeconds(remainingMs)
        val hours = totalSeconds / 3600
        val minutes = (totalSeconds % 3600) / 60
        val seconds = totalSeconds % 60
        binding.myTextView.text = String.format("%dh %dm %ds", hours, minutes, seconds)
    }
}

优化点说明 #

• 统一用Instant处理UTC时间，完全规避时区偏差问题
• 所有时间差统一用毫秒计算，避免单位换算错误
• 移除冗余的Duration依赖，直接用基础算术运算计算时分秒，计算结果的秒数永远在0-59范围内，不会出现异常值
• 自带过期兜底逻辑，避免负数时间导致的格式错误

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