Kotlin 时间

Kotlin 是一种运行于 JVM, 并支持多种平台的现代编程语言。由 JetBrains 开发并于 2016 年发布，设计宗旨是提高代码质量和开发效率。作为一门静态类型的语言，Kotlin 具有现代化的特性，比如类型推导、Lambda 表达式、扩展函数、函数式编程等等。在处理时间和日期方面，Kotlin 也提供了强大的支持。

时间 API

在 Kotlin 中，日期和时间的 API 都包含在两个包中：java.time 和 kotlin.time。前者是 Java 8 引入的新的日期和时间的 API，后者是 Kotlin 引入的专门用于 Kotlin 的时间 API。其中，java.time 包含了日期和时间的所有信息，这篇介绍着重介绍 kotlin.time 的 API。

基本时间单位

在 Kotlin 中，时间都是基于 Duration 和 Instant 类型。Duration 单位为纳秒，满足基本时间单位的定义。而 Instant 表示从 Unix 时间纪元（1970年1月1日 UTC）开始测量的瞬时时间点。实际上，Instant 就是一个长整型数，存储的是距离纪元开始的纳秒数。我们可以使用 Duration 来表示一段时间，使用 Instant 来计算两个时间点之间的差距，或者将其转换为本地日期时间。

操作符

在 Kotlin 1.5 版本中，还引入了对 Duration 和 Instant 的内置支持。系统提供了一组标准的运算符，可以用于直接进行时间计算操作。例如，+ 运算符可以将两个 Duration 对象相加，- 运算符可以将一个 Duration 减去另一个时间段。同样也可以直接使用 + 运算符将 Duration 加上或减去一个标准的时间单位（例如分钟、小时或日）。

val duration: Duration = 30.seconds
val newDuration = duration + 5.minutes

使用示例

获取当前时间

import kotlin.time.ExperimentalTime
import kotlin.time.Clock.System.now

@ExperimentalTime
fun getCurrentTime(): Instant {
    return now()
}

时间差计算

import kotlin.time.ExperimentalTime

@ExperimentalTime
fun diffBetweenTime(): Duration {
    val startTime = Instant.now()
    // do some work here...
    val endTime = Instant.now()
    return endTime - startTime
}

时间格式化

import kotlin.time.ExperimentalTime
import kotlin.time.Duration.Companion.milliseconds

@ExperimentalTime
fun formatDuration(): String {
    return 1000.milliseconds.toString()
}

总结

Kotlin 的时间 API 提供了强大的支持，在处理时间和日期上比 Java 8 的 java.time 更为简便。在 Kotlin 中，我们可以轻松获取当前时间、计算时间差以及进行时间格式化。Kotlin 时间的内置支持和操作符是此 API 我们最为贴心的部分。