Kotlin中如何校验指定格式时间戳是否合法且不属于未来时间？

无论在Java还是Kotlin环境下，都不推荐使用老旧的SimpleDateFormat实现日期校验，它存在线程不安全、API设计缺陷等诸多问题。Java 8之后引入的java.time（JSR-310）时间API是处理这类需求的最优选择，Kotlin可以直接无缝调用这套API。

为什么不推荐你之前的SimpleDateFormat方案 #

• SimpleDateFormat是可变类，天生线程不安全，多线程环境下共享同一个实例会出现解析结果错乱
• 即使开启setLenient(false)严格模式，它的格式匹配逻辑依然存在很多容错漏洞，容易出现误判
• 你代码中写的格式模板"dd-MM-yyyy HH:mm:ss:ms"本身存在错误：毫秒的正确占位符是SSS，且这个模板和你接口返回的2022-01-01T00:00:00.000+02:00（ISO 8601带时区偏移格式）完全不匹配，根本无法正确解析目标值。

实现代码 #

你需要处理的时间格式是标准ISO 8601偏移时间格式，java.time包下的OffsetDateTime原生支持解析该格式，不需要手动编写匹配模板。

import java.time.OffsetDateTime
import java.time.ZoneOffset
import java.time.format.DateTimeParseException

/**
 * 校验接口返回的时间字符串
 * @return 第一个值为是否校验通过，第二个值为校验结果说明
 */
fun checkApiTime(timeStr: String): Pair<Boolean, String> {
    // 1. 格式合法性校验
    val parsedTime = try {
        OffsetDateTime.parse(timeStr.trim())
    } catch (e: DateTimeParseException) {
        return Pair(false, "时间格式非法")
    }

    // 2. 未来时间校验，统一转UTC时区对比避免时差误差
    val currentUtcTime = OffsetDateTime.now(ZoneOffset.UTC)
    val inputUtcTime = parsedTime.withOffsetSameInstant(ZoneOffset.UTC)
    return if (inputUtcTime.isAfter(currentUtcTime)) {
        Pair(true, "校验通过，为合法未来时间")
    } else {
        Pair(false, "时间格式合法，但不属于未来时间")
    }
}

关键说明 #

• OffsetDateTime、DateTimeFormatter都是不可变类，天生线程安全，可以定义为全局常量复用，没有并发风险
• 时间比较前统一转换为UTC时区，避免不同时区偏移导致的判断误差
• 如果后续接口返回非标准格式的时间，只需要自定义线程安全的DateTimeFormatter实例传入parse方法即可，示例如下：

  // 全局定义一次即可，可多线程复用
  private val CUSTOM_TIME_FORMAT = DateTimeFormatter.ofPattern("dd-MM-yyyy HH:mm:ss.SSS")
  // 解析时调用
  // OffsetDateTime.parse(timeStr, CUSTOM_TIME_FORMAT)
  

• 如果你在Android API 26以下版本开发，引入ThreeTen回溯库即可使用上述全套API，逻辑不需要做任何改动。

内容的提问来源于stack exchange，提问作者Víctor Martín