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

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

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

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

```
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] message text
```

Часова мітка конверта **за замовчуванням відповідає локальному часу хоста**, незалежно від часового поясу провайдера.
Змініть це в `agents.defaults`:

```json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | часовий пояс IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
```

| Ключ                | Значення                                                   | Поведінка                                                                                                                                                                                                 |
| ------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `envelopeTimezone`  | `local` (типово), `utc`, `user`, явна назва часового поясу IANA | `user` використовує `agents.defaults.userTimezone` (часовий пояс хоста, якщо значення не задано). Явна назва IANA (наприклад, `"America/Chicago"`) закріплює фіксований часовий пояс; нерозпізнані назви спричиняють перехід до UTC. |
| `envelopeTimestamp` | `on` (типово), `off`                                       | `off` вилучає абсолютні часові мітки із заголовків конвертів, прямих префіксів промптів агента та вбудованих префіксів вхідних даних моделі.                                                                |
| `envelopeElapsed`   | `on` (типово), `off`                                       | `off` вилучає суфікс тривалості (у форматі `+30s` / `+2m`), що показує час від попереднього повідомлення в сеансі.                                                                                         |

### Приклади

**Локальний час (типово):**

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

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

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

**Тривалість із `envelopeTimezone: "utc"`:**

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

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

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

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

Якщо налаштовано `agents.defaults.userTimezone`, використовується цей часовий пояс; інакше — часовий пояс хоста.
Промпт також вказує агенту запускати інструмент `session_status`, коли йому потрібні
поточна дата, час або день тижня.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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