​

Date & Time(日期與時間)

​

訊息 envelopes（預設為本地）

[Provider ... 2026-01-05 16:26 PST] message text

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

• envelopeTimezone: "utc" 使用 UTC。
• envelopeTimezone: "local" 使用主機時區。
• envelopeTimezone: "user" 使用 agents.defaults.userTimezone（回退到主機時區）。
• 使用明確的 IANA 時區（例如 "America/Chicago"）作為固定區域。
• envelopeTimestamp: "off" 從 envelope headers 中移除絕對時間戳記。
• envelopeElapsed: "off" 移除經過時間後綴（+2m 樣式）。

​

範例

[WhatsApp +1555 2026-01-18 00:19 PST] hello

[WhatsApp +1555 2026-01-18 00:19 CST] hello

[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

​

系統提示詞：Current Date & Time

Time zone: America/Chicago

​

系統事件行（預設為本地）

System: [2026-01-12 12:19:17 PST] Model switched.

​

設定使用者時區 + 格式

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

• userTimezone 設定提示詞上下文的使用者本地時區。
• timeFormat 控制提示詞中的 12h/24h 顯示。auto 遵循 OS 偏好。

​

時間格式偵測（auto）

​

工具 payloads + connectors（原始供應商時間 + 標準化欄位）

• timestampMs：epoch 毫秒（UTC）
• timestampUtc：ISO 8601 UTC 字串

• Slack：來自 API 的 epoch-like 字串
• Discord：UTC ISO 時間戳記
• Telegram/WhatsApp：供應商特定的數字/ISO 時間戳記

​

相關文件

• System Prompt
• Timezones
• Messages