> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Дата й час

OpenClaw за замовчуванням використовує **локальний час хоста для часових міток транспорту** і **часовий пояс користувача лише в системному промпті**.
Часові мітки провайдера зберігаються, щоб інструменти зберігали свою нативну семантику (поточний час доступний через `session_status`).

## Конверти повідомлень (локальні за замовчуванням)

Вхідні повідомлення обгортаються часовою міткою (точність до секунди):

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

Ця часова мітка конверта **за замовчуванням є локальною для хоста**, незалежно від часового поясу провайдера.

Ви можете перевизначити цю поведінку:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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"` вилучає абсолютні часові мітки із заголовків конвертів, префіксів прямого промпта агента та вбудованих префіксів вхідних даних моделі.
* `envelopeElapsed: "off"` вилучає суфікси минулого часу (стиль `+2m`).

### Приклади

**Локальний (за замовчуванням):**

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

**Часовий пояс користувача:**

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

**Минулий час увімкнено:**

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

## Системний промпт: поточна дата й час

Якщо часовий пояс користувача відомий, системний промпт містить окремий
розділ **Поточна дата й час** із **лише часовим поясом** (без формату годинника/часу),
щоб кешування промпта залишалося стабільним:

```
Time zone: America/Chicago
```

Коли агенту потрібен поточний час, використовуйте інструмент `session_status`; картка
статусу містить рядок із часовою міткою.

## Рядки системних подій (локальні за замовчуванням)

Системні події в черзі, вставлені в контекст агента, мають префікс із часовою міткою, що використовує
той самий вибір часового поясу, що й конверти повідомлень (за замовчуванням: локальний час хоста).

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

### Налаштування часового поясу користувача й формату

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
```

* `userTimezone` задає **локальний часовий пояс користувача** для контексту промпта.
* `timeFormat` керує **відображенням у 12-годинному/24-годинному форматі** в промпті. `auto` дотримується налаштувань ОС.

## Визначення формату часу (auto)

Коли `timeFormat: "auto"`, OpenClaw перевіряє налаштування ОС (macOS/Windows)
і повертається до форматування локалі. Визначене значення **кешується для кожного процесу**,
щоб уникнути повторних системних викликів.

## Корисні навантаження інструментів + конектори (сирий час провайдера + нормалізовані поля)

Інструменти каналів повертають **нативні часові мітки провайдера** і додають нормалізовані поля для узгодженості:

* `timestampMs`: мілісекунди епохи (UTC)
* `timestampUtc`: рядок UTC у форматі ISO 8601

Сирі поля провайдера зберігаються, щоб нічого не втратити.

* Slack: схожі на епоху рядки з API
* Discord: часові мітки UTC ISO
* Telegram/WhatsApp: числові/ISO часові мітки, специфічні для провайдера

Якщо вам потрібен локальний час, перетворіть його нижче за потоком, використовуючи відомий часовий пояс.

## Пов’язані документи

* [Системний промпт](/uk/concepts/system-prompt)
* [Часові пояси](/uk/concepts/timezone)
* [Повідомлення](/uk/concepts/messages)