Date Time 导读

时间戳用谁的时区?默认是主机本地,但可以改

消息信封和系统事件的时间戳默认取主机本地时间,不跟随用户或 provider。如果你想让时间戳显示用户时区或固定 UTC,在 agents.defaults 里配 envelopeTimezone。注意:系统提示里只放时区名不放具体时间,要拿当前时间得调 session_status 工具。

先讲这一页到底在解决什么

时间戳用谁的时区?默认是主机本地,但可以改

消息信封和系统事件的时间戳默认取主机本地时间,不跟随用户或 provider。如果你想让时间戳显示用户时区或固定 UTC,在 agents.defaults 里配 envelopeTimezone。注意:系统提示里只放时区名不放具体时间,要拿当前时间得调 session_status 工具。

原文共 9 节,先看 Start Here 路径:/date-time 查看官方原文

第一站

📦 消息外壳里的时间,默认用主机本地时间

消息到 Gateway 时会套一个时间外壳,默认就是主机本地时区,不会自动改成提供商的时区。

host-local

像用这台机器自己的表来打包。

provider timestamp preserved

像保留原消息自带的原始时间印记。

session_status

像随时能问当前时间的总时钟。

第二站

🧩 配置项像几个不同的时间滤镜

你可以让时间外壳换成 UTC、local、user 或固定 IANA 时区。

envelopeTimezone

像决定这封包裹票据上写的是哪个时区。

envelopeTimestamp

像决定票据上要不要印绝对时间。

envelopeElapsed

像决定要不要再附上一段“过了多久”的小尾巴。

第三站

🗣 系统提示词里的 user timezone,才是“说给人听”的那个时区

官方把“机器传输时间”和“人读到的时间”分开,就是怕你误会系统什么时候在讲谁的钟。

默认运输

按主机本地。

人类说明

按用户时区讲故事。

一句话

一个是机器记账,一个是人类读说明,别混淆。