登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  Redis

Redis TIME 怎样取得服务端秒数与微秒部分

来源:17golang原创

时间:2026-11-18 17:16:43 147浏览 收藏

如果应用需要以 Redis 所在节点的时钟为准,直接执行 TIME 即可。它不接收参数,返回一个包含两个元素的列表:第一项是 Unix 时间戳的秒数,第二项是当前这一秒已经过去的微秒数。两项要一起解释,不能把第二项当成另一份完整时间戳。

官方地址:https://redis.io/docs/latest/commands/time/

迁移旧代码时,最稳妥的做法是先保留 Redis TIME 的“两段式”返回,再在应用边界统一组合成微秒或时间对象。这样既能使用服务端时钟,也不会丢掉微秒部分的含义。

TIME 的返回值到底表示什么

TIME 的返回顺序固定为“秒数、微秒部分”。例如返回 1784722081 和 827551 时,完整含义是 Unix 纪元后的第 1784722081 秒,并且当前秒已经过去 827551 微秒。

位置含义使用方式
第 1 项Unix 时间戳,单位是秒用于日期、秒级过期和跨系统传输
第 2 项当前秒内已经过去的微秒数范围是 0 到 999999,用于补足精度
Redis TIME 返回秒数和微秒部分的静态结构说明图
图1:结构说明图,查看 TIME、服务端时钟、秒数和当前秒内微秒部分之间的静态关系。

从命令行读取两段时间

在可以访问 Redis 的环境中,命令行只需发送一次 TIME:

# 读取 Redis 服务端当前时间;两行分别对应秒数和当前秒内微秒数
redis-cli TIME

# 典型返回:第一行是 Unix 秒数,第二行是微秒部分
1) "1784722081"
2) "827551"

这里的输出是 Redis 协议返回值的文字示意,不是文章配图中的运行截图。若只想记录秒级时间,可以取第一项;需要微秒精度时,必须同时保留第二项。

组合成微秒数或应用时间

跨服务传输时,常见做法是把两项组合成一个整数:seconds × 1000000 + microseconds。如果目标语言提供纳秒字段,则应把微秒乘以 1000 后再传入,而不是直接把它当作纳秒。

package main

import (
    "fmt"
    "time"
)

func main() {
    seconds := int64(1784722081) // Redis TIME 的第一项:Unix 秒数
    micros := int64(827551)      // Redis TIME 的第二项:当前秒内微秒数

    unixMicros := seconds*1_000_000 + micros // 先统一为微秒,避免量纲混淆
    current := time.Unix(seconds, micros*1_000) // Go 的第二参数使用纳秒

    fmt.Println(unixMicros)
    fmt.Println(current.UTC().Format(time.RFC3339Nano)) // 仅格式化展示,不改变原始时间
}

组合时要注意整数范围:如果把秒数和微秒数放进 32 位整数,长期运行很容易溢出。服务端返回的两项也可能以字符串形式到达客户端,解析后再做整数运算更安全。

Redis TIME 两段返回组合为微秒数和时间对象的静态关系图
图2:关系说明图,查看秒数、微秒部分与微秒整数、应用时间对象之间的静态转换关系。

从本机时间迁移到 Redis TIME 时要检查什么

如果旧代码使用应用服务器的本机时钟,切换到 TIME 后,时间基准会变成 Redis 服务端。这个变化适合需要以缓存节点或主节点时间为准的场景,但也意味着多节点部署时要明确“哪个 Redis 节点”是权威来源。

  • 秒数与微秒部分一起读取,不要只保存第二项。
  • 比较两个时间时先统一单位,避免把秒和微秒直接相减。
  • TIME 是墙上时钟读取,不提供单调递增保证;统计耗时应使用应用语言的单调时钟。
  • 需要过期控制时优先使用 Redis 的过期命令或 TTL 语义,不要把一次 TIME 结果当成持续计时器。

官方文档将 TIME 标记为 O(1),并说明该命令从 Redis 2.6.0 开始提供。迁移检查的重点不是改写命令,而是确认旧代码对时钟来源、精度和单调性的假设。

相关问题

Redis TIME 的第二项是不是微秒级 Unix 时间戳?

不是。第二项只是当前这一秒内已经过去的微秒数,必须和第一项按 秒 × 1000000 + 微秒 组合后,才得到完整的 Unix 微秒数。

TIME 能不能用来测接口耗时?

不建议把它作为单调计时器。网络往返和系统校时都会影响墙上时钟;接口耗时应优先使用应用进程提供的单调时钟,TIME 更适合取得 Redis 服务端的当前时间。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>