当前位置:首页 > 文章列表 > 数据库 > Redis > Redis TIME 怎样取得服务端秒数与微秒部分

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

来源:17golang原创 2026-11-18 17:16:43 0浏览 收藏

如果应用需要以 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删除
Go go/types.Signature.Variadic 怎样识别签名中的可变参数Go go/types.Signature.Variadic 怎样识别签名中的可变参数
上一篇
Go go/types.Signature.Variadic 怎样识别签名中的可变参数
Transformers BaseModelOutput.hidden_states 怎样区分各层隐藏状态与最后一层输出
下一篇
Transformers BaseModelOutput.hidden_states 怎样区分各层隐藏状态与最后一层输出
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1258次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1200次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1047次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码