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

# Format Date

> Định dạng ngày và giờ trong Flow ChatbotX bằng mẫu date-fns trước khi hiển thị cho khách hàng hoặc dùng trong tự động hóa.

**Format Date** chuyển giá trị ngày hoặc giờ sang định dạng mà Flow cần dùng. Dùng Action này khi hệ thống lưu ngày theo một định dạng nhưng khách hàng, nhân viên hoặc bước tiếp theo trong Flow cần cách hiển thị khác.

Ví dụ: bạn có thể chuyển `2026-08-11T14:30:00` thành `11/08/2026`, `11 Aug 2026` hoặc `14:30`.

## Thêm Format Date vào Flow

<Steps>
  <Step title="Mở Flow">
    Mở Flow có giá trị ngày hoặc giờ cần định dạng.
  </Step>

  <Step title="Thêm node Perform Action">
    Thêm node **Perform Action** trước tin nhắn hoặc Condition sẽ dùng giá trị đã định dạng.
  </Step>

  <Step title="Chọn Format Date">
    Mở node, nhấn **Create**, sau đó chọn **Tools > Format Date**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/GMkdbZ1eGBhC4VPX/images/select_format_date_in_tools_menu.png?fit=max&auto=format&n=GMkdbZ1eGBhC4VPX&q=85&s=51817a5ea260970371f94ba07f84fb5c" alt="Select Format Date in the Tools menu" width="2862" height="1885" data-path="images/select_format_date_in_tools_menu.png" />
    </Frame>
  </Step>

  <Step title="Chọn giá trị và định dạng">
    Chọn **Input Custom Field**, nhập mẫu date-fns vào **Format**, chọn **Output Custom Field**, sau đó chọn **Timezone** và nhấn **Save**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/GMkdbZ1eGBhC4VPX/images/format_date_action.png?fit=max&auto=format&n=GMkdbZ1eGBhC4VPX&q=85&s=610614e779d83147526a13929ddf54c3" alt="Configure Format Date in a Perform Action node" width="2862" height="1889" data-path="images/format_date_action.png" />
</Frame>

## Dùng mẫu định dạng date-fns

ChatbotX dùng kiểu định dạng của date-fns. Bạn có thể dùng [date-fns interactive formatter](https://date-fns-interactive.netlify.app/) để thử mẫu trước khi thêm vào Flow.

| Mẫu                  | Ví dụ kết quả             | Ý nghĩa                               |
| -------------------- | ------------------------- | ------------------------------------- |
| `yyyy-MM-dd`         | `2026-08-11`              | Năm bốn chữ số, tháng và ngày         |
| `dd/MM/yyyy`         | `11/08/2026`              | Ngày, tháng và năm bốn chữ số         |
| `dd MMM yyyy`        | `11 Aug 2026`             | Ngày, tháng viết tắt và năm           |
| `EEEE, dd MMMM yyyy` | `Tuesday, 11 August 2026` | Thứ đầy đủ, ngày, tháng đầy đủ và năm |
| `HH:mm`              | `14:30`                   | Giờ 24 tiếng và phút                  |
| `HH:mm:ss`           | `14:30:00`                | Giờ 24 tiếng, phút và giây            |

Dùng `MM` viết hoa cho tháng và `mm` viết thường cho phút. Dùng `yyyy` cho năm dương lịch bốn chữ số.

## Chọn nguồn, nơi lưu và múi giờ

* **Input Custom Field:** Trường lưu ngày hoặc giờ gốc.
* **Format:** Mẫu date-fns quyết định kết quả hiển thị.
* **Output Custom Field:** Trường ChatbotX lưu giá trị đã định dạng. Dùng **Add** khi cần tạo Custom Field mới.
* **Timezone:** Múi giờ dùng để định dạng giá trị. Chọn **Contact Timezone** khi ngày giờ cần theo múi giờ của liên hệ.

## Ví dụ: hiển thị ngày giao hàng

Flow lưu ngày giao hàng trong một Custom Field. Thêm **Format Date** trước tin nhắn xác nhận, sau đó dùng `dd/MM/yyyy` để khách hàng thấy ngày theo định dạng quen thuộc.

<Note>
  Hãy thử mẫu với một giá trị ngày thực trước khi Publish Flow. Bạn sẽ xác nhận được ngày, tháng và giờ xuất hiện đúng thứ tự cần dùng.
</Note>