获取Instant毫秒值

在 Java/Kotlin 中，Instant 类表示时间线上的一个精确时刻（UTC 时间），可以通过其 toEpochMilli() 方法直接获取对应的毫秒级时间戳（即从 Unix 纪元时间 1970-01-01T00:00:00Z 开始的毫秒数）。

核心方法：toEpochMilli()

• 作用：将 Instant 转换为自纪元以来的毫秒数（long 类型）。
• 注意：若 Instant 为 null，调用该方法会抛出 NullPointerException，需提前判断。

代码示例（Kotlin）

1. 获取当前时间的 Instant 毫秒值

import java.time.Instant

fun main() {
    // 获取当前时间的Instant（UTC时间）
    val now = Instant.now()
    
    // 转换为毫秒值
    val epochMilli: Long = now.toEpochMilli()
    
    println("当前时间的Instant毫秒值：$epochMilli")
    // 输出示例：当前时间的Instant毫秒值：1691023567890
}

2. 从文件创建时间（Instant）获取毫秒值

结合之前 “查看文件创建日期” 的场景，将文件的创建时间 Instant 转换为毫秒值：

import java.nio.file.Files
import java.nio.file.Paths
import java.nio.file.attribute.BasicFileAttributes
import java.time.Instant

fun getFileCreationTimeMilli(filePath: String): Long? {
    return try {
        val path = Paths.get(filePath)
        val attributes: BasicFileAttributes = Files.readAttributes(path, BasicFileAttributes::class.java)
        val creationInstant: Instant = attributes.creationTime().toInstant()
        
        // 转换为毫秒值
        creationInstant.toEpochMilli()
    } catch (e: Exception) {
        e.printStackTrace()
        null
    }
}

// 使用示例
fun main() {
    val filePath = "/path/to/your/file.txt"
    val creationMilli = getFileCreationTimeMilli(filePath)
    
    if (creationMilli != null) {
        println("文件创建时间的毫秒值：$creationMilli")
        // 输出示例：文件创建时间的毫秒值：1690932156789
    } else {
        println("无法获取文件创建时间的毫秒值")
    }
}

说明

• 毫秒值的含义：返回的 long 类型数值是 Unix 时间戳的毫秒级表示，可用于时间比较、计算时间差、存储等场景（例如：两个时间的毫秒值相减，得到时间间隔的毫秒数）。
• 精度：Instant 本身支持纳秒级精度，但 toEpochMilli() 会截断为毫秒级（丢弃纳秒部分）。若需纳秒级，可使用 getEpochSecond() * 1000 + getNano() / 1_000_000 计算（但通常毫秒级已满足大多数需求）。

通过 toEpochMilli() 方法，可便捷地将 Instant 转换为常用的毫秒级时间戳。

转自：获取 Instant 毫秒值 - 豆包