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:
# 读取 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 时要检查什么
如果旧代码使用应用服务器的本机时钟,切换到 TIME 后,时间基准会变成 Redis 服务端。这个变化适合需要以缓存节点或主节点时间为准的场景,但也意味着多节点部署时要明确“哪个 Redis 节点”是权威来源。
- 秒数与微秒部分一起读取,不要只保存第二项。
- 比较两个时间时先统一单位,避免把秒和微秒直接相减。
- TIME 是墙上时钟读取,不提供单调递增保证;统计耗时应使用应用语言的单调时钟。
- 需要过期控制时优先使用 Redis 的过期命令或 TTL 语义,不要把一次 TIME 结果当成持续计时器。
官方文档将 TIME 标记为 O(1),并说明该命令从 Redis 2.6.0 开始提供。迁移检查的重点不是改写命令,而是确认旧代码对时钟来源、精度和单调性的假设。
相关问题
Redis TIME 的第二项是不是微秒级 Unix 时间戳?
不是。第二项只是当前这一秒内已经过去的微秒数,必须和第一项按 秒 × 1000000 + 微秒 组合后,才得到完整的 Unix 微秒数。
TIME 能不能用来测接口耗时?
不建议把它作为单调计时器。网络往返和系统校时都会影响墙上时钟;接口耗时应优先使用应用进程提供的单调时钟,TIME 更适合取得 Redis 服务端的当前时间。
-
374 收藏
-
398 收藏
-
117 收藏
-
426 收藏
-
171 收藏
-
405 收藏
-
427 收藏
-
287 收藏
-
349 收藏
-
357 收藏
-
223 收藏
-
121 收藏
-
283 收藏
-
491 收藏
-
309 收藏
-
240 收藏
-
254 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习