---
read_when:
    - Ви змінюєте спосіб відображення часових позначок для моделі або користувачів
    - Ви налагоджуєте форматування часу в повідомленнях або виводі системного промпта
summary: Обробка дати й часу в конвертах, промптах, інструментах і конекторах
title: Дата й час
x-i18n:
    generated_at: "2026-05-06T04:19:45Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5f695a5009c949cc24689bfb8950d96cf72f0b2a1472efe88923182527b56b74
    source_path: date-time.md
    workflow: 16
---

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

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

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

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

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

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

```json5
{
  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 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
```

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

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

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

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

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

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

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

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

```json5
{
  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: схожі на epoch рядки з API
- Discord: часові позначки UTC ISO
- Telegram/WhatsApp: числові/ISO часові позначки, специфічні для провайдера

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

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

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