Skip to main content

Timezones

WednesdayAI standardizes timestamps so the model sees a single reference time.

Message envelopes (local by default)

Inbound messages are wrapped in an envelope like:
The timestamp in the envelope is host-local by default, with minutes precision. You can override this with:
  • envelopeTimezone: "utc" uses UTC.
  • envelopeTimezone: "user" uses agents.defaults.userTimezone (falls back to host timezone).
  • Use an explicit IANA timezone (e.g., "Europe/Vienna") for a fixed offset.
  • envelopeTimestamp: "off" removes absolute timestamps from envelope headers, disables the stamp on user turns, and drops the timestamp prevention line from the system prompt.
  • envelopeElapsed: "off" removes elapsed time suffixes (the +2m style).

Examples

Local (default):
Fixed timezone:
Elapsed time:

Tool payloads (raw provider data + normalized fields)

Tool calls (channels.discord.readMessages, channels.slack.readMessages, etc.) return raw provider timestamps. We also attach normalized fields for consistency:
  • timestampMs (UTC epoch milliseconds)
  • timestampUtc (ISO 8601 UTC string)
Raw provider fields are preserved.

User timezone for the system prompt

Set agents.defaults.userTimezone to tell the model the user’s local time zone. If it is unset, WednesdayAI resolves the host timezone at runtime (no config write).
The system prompt includes a Current Date & Time section with the time zone. When message stamps are on (the default), it also carries a line telling the model never to begin a reply with a timestamp. User turns are stamped [Ddd YYYY-MM-DD HH:MM GMT±H] in this zone; stored messages keep their raw text. You can control the prompt format with agents.defaults.timeFormat (auto | 12 | 24). See Date & Time for the full behavior and examples.