如何流畅结合使用Kotlin Duration与Java Time？

一、设计层面的核心考量 #

Kotlin的Duration是标准库为跨平台场景（JVM、JS、Native）打造的时间间隔工具，而java.time是Java专属的标准API。二者分属不同生态，Kotlin团队在设计Duration时优先保证自身API的一致性和跨平台能力：如果直接绑定java.time类，会导致JS、Native平台无法使用该API，破坏Kotlin的跨平台设计初衷。

另外，Kotlin Duration的语法设计更偏向Kotlin风格，比如支持1.days、2.hours这类直观的字面量写法，和java.time.Duration的通用型设计目标有差异——后者是Java生态的通用时间间隔载体，前者则是Kotlin为简化语法、统一跨平台时间操作定制的工具。

二、为何标准库不提供Java类的扩展函数？ #

核心原因还是跨平台限制：如果Kotlin标准库给OffsetDateTime这类java.time类添加接收Kotlin Duration的扩展，这些扩展只能在JVM平台生效，会增加标准库的平台差异复杂度，违背跨平台设计原则。不过官方完全鼓励开发者自行实现这类扩展，适配自身的JVM场景需求。

三、流畅结合二者的实用方案 #

1. 自定义全局扩展函数 #

自己给java.time的时间类编写扩展，直接兼容Kotlin Duration：

import java.time.temporal.Temporal
import kotlin.time.Duration
import kotlin.time.toJavaDuration

// 为所有支持加减操作的时间类添加扩展
fun Temporal.plus(duration: Duration): Temporal = this.plus(duration.toJavaDuration())
fun Temporal.minus(duration: Duration): Temporal = this.minus(duration.toJavaDuration())

之后就能实现你期望的流畅调用：

OffsetDateTime.now().plus(1.days) // 可正常运行
OffsetDateTime.now().minus(3.hours)

2. 封装工具类（避免全局扩展冲突） #

如果不想全局添加扩展，可封装工具方法限定使用范围：

object KtTimeBridge {
    fun Temporal.plusKt(duration: Duration): Temporal = this.plus(duration.toJavaDuration())
    fun Temporal.minusKt(duration: Duration): Temporal = this.minus(duration.toJavaDuration())
}

使用时通过导入工具类扩展调用：

import your.package.KtTimeBridge.plusKt
OffsetDateTime.now().plusKt(1.days)

3. 简化转换的语法糖 #

如果不想写扩展，也可以利用Kotlin运算符重载简化代码：

val now = OffsetDateTime.now()
val later = now + 1.days.toJavaDuration()

这种方式虽仍需转换，但比原写法更简洁。

内容的提问来源于stack exchange，提问作者Andrew S.