---
read_when:
    - Ви змінюєте спосіб відображення часових позначок для моделі або користувачів
    - Ви налагоджуєте форматування часу в повідомленнях або виводі системного промпта
summary: Обробка дати й часу в конвертах, промптах, інструментах і конекторах
title: Дата й час
x-i18n:
    generated_at: "2026-06-27T17:29:53Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d40e8626269d26a14506a178080b353529080b6ee5ce523c3281521f1a34bf90
    source_path: date-time.md
    workflow: 16
---

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

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

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

```
[Provider ... Mon 2026-01-05 16:26:34 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 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
{
  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)