---
read_when:
    - คุณกำลังเปลี่ยนวิธีแสดงเวลาประทับให้โมเดลหรือผู้ใช้เห็น
    - คุณกำลังดีบักการจัดรูปแบบเวลาในข้อความหรือเอาต์พุตของพรอมป์ระบบ
summary: การจัดการวันที่และเวลาใน envelope, prompt, tools และตัวเชื่อมต่อ
title: วันที่และเวลา
x-i18n:
    generated_at: "2026-06-27T17:31:11Z"
    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` ควบคุม **การแสดงผลแบบ 12h/24h** ในพรอมป์. `auto` ทำตามค่ากำหนดของระบบปฏิบัติการ.

## การตรวจหารูปแบบเวลา (อัตโนมัติ)

เมื่อ `timeFormat: "auto"` OpenClaw จะตรวจสอบค่ากำหนดของระบบปฏิบัติการ (macOS/Windows)
และถอยกลับไปใช้การจัดรูปแบบตามโลแคล ค่าที่ตรวจพบจะถูก **แคชต่อโปรเซส**
เพื่อหลีกเลี่ยงการเรียกระบบซ้ำ

## เพย์โหลดเครื่องมือ + ตัวเชื่อมต่อ (เวลาผู้ให้บริการดิบ + ฟิลด์ที่ทำให้เป็นมาตรฐาน)

เครื่องมือของช่องทางส่งคืน **การประทับเวลาแบบดั้งเดิมของผู้ให้บริการ** และเพิ่มฟิลด์ที่ทำให้เป็นมาตรฐานเพื่อความสอดคล้อง:

- `timestampMs`: มิลลิวินาที epoch (UTC)
- `timestampUtc`: สตริง UTC ISO 8601

ฟิลด์ดิบของผู้ให้บริการจะถูกเก็บไว้เพื่อไม่ให้ข้อมูลใดสูญหาย

- Slack: สตริงลักษณะ epoch จาก API
- Discord: การประทับเวลา ISO แบบ UTC
- Telegram/WhatsApp: การประทับเวลาแบบตัวเลข/ISO เฉพาะผู้ให้บริการ

หากคุณต้องการเวลาท้องถิ่น ให้แปลงในขั้นปลายทางโดยใช้เขตเวลาที่ทราบ

## เอกสารที่เกี่ยวข้อง

- [พรอมป์ระบบ](/th/concepts/system-prompt)
- [เขตเวลา](/th/concepts/timezone)
- [ข้อความ](/th/concepts/messages)