Định dạng ngày và giờ

Sử dụng các chức năng ngày và giờ để chuyển đổi và biến đổi dữ liệu ngày và giờ. Ví dụ, bạn có thể thay đổi định dạng ngày, chuyển đổi giờ dựa trên múi giờ, chuyển đổi văn bản thành dữ liệu ngày hoặc giờ, và nhiều hơn nữa. Dưới đây là danh sách các chức năng ngày và giờ được hỗ trợ trong AhaChat cùng với mô tả và chi tiết cho từng chức năng.

Cách sử dụng

Tạo block Thuộc tính trong kịch bản AhaChat để lưu thuộc tính với giá trị là các tham số ngày giờ cần định dạng.

Ví dụ: {{formatDate(date, MM-DD-YYYY)}} → trong đó date là thuộc tính chứa ngày/giờ của khách hàng.

{{formatDate(date, format, [timezone])}}

Khi nào sử dụng: Bạn có một giá trị Ngày mà bạn muốn chuyển đổi (định dạng) thành một giá trị Văn bản (biểu diễn có thể đọc được) như 12-10-2015 20:30 hoặc 18 tháng 8 năm 2025 10:00 AM.

Tham số

• date: Giá trị Ngày cần chuyển đổi.

• format: Định dạng được chỉ định cho ngày/giờ. Ví dụ: DD.MM.YYYY HH:mm

• timezone: (Tùy chọn) Múi giờ được sử dụng cho việc chuyển đổi, xem danh sách tại đây.

Lưu ý

Chỉ các giá trị được liệt kê trong cột "TZ identifier" được công nhận như một múi giờ hợp lệ.

Giá trị trả về và loại

Biểu diễn văn bản của giá trị Ngày đã cho theo định dạng và múi giờ đã chỉ định. Loại là Văn bản.

Ví dụ

Các ví dụ dưới đây sử dụng múi giờ đầu vào là: Asia/Ho_Chi_Minh

• {{formatDate(2025-10-01, MM/DD/YYYY )}} = 10/01/2015

• {{formatDate(01/10/2025 09:30:00, YYYY-MM-DD HH:mm A)}} = 2015-10-01 09:30 AM

• {{formatDate(01/10/2025 21:30:00, YYYY-MM-DD HH:mm A)}} = 2015-10-01 21:32 PM

• {{formatDate(2025-10-01 07:00:00, DD.MM.YYYY HH:mm, America/Chicago)}} = 30.09.2025 18:00

{{addSeconds(date, number)}}

Trả về một ngày mới là kết quả của việc cộng thêm một số giây nhất định vào một ngày.

• {{addSeconds(08-12-2025 15:55:20, 2)}} = 08-12-2025 15:55:22

{{addMinutes(date, number)}}

Trả về một ngày mới là kết quả của việc cộng thêm một số phút nhất định vào một ngày.

• {{addMinutes(08-12-2025 15:55:20, 2)}} = 08-12-2025 15:57:20

{{addHours(date, number)}}

Trả về một ngày mới là kết quả của việc cộng thêm một số giờ nhất định vào một ngày.

• {{addHours(08-12-2025 15:55:20, 2)}} = 08-12-2025 17:55:20

{{addDays(date, number)}}

Trả về một ngày mới là kết quả của việc cộng thêm một số ngày nhất định vào một ngày.

• {{addDays(08-12-2025 15:55:20, 2)}} = 10-12-2025 15:55:20

{{addMonths(date, number)}}

Trả về một ngày mới là kết quả của việc cộng thêm một số tháng nhất định vào một ngày.

• {{addMonths(08-12-2025 15:55:20, 2)}} = 08-02-2025 15:55:20

{{addYears(date, years)}}

Trả về một ngày mới là kết quả của việc cộng thêm một số năm nhất định vào một ngày.

• {{addYears(08-12-2025 15:55:20, 2)}} = 08-12-2027 15:55:20

{{subSeconds(date, number)}}

Trả về một ngày mới là kết quả của việc trừ một số giây nhất định vào một ngày.

• {{subSeconds(08-12-2025 15:55:20, 2)}} = 08-12-2025 15:55:18

{{subMinutes(date, number)}}

Trả về một ngày mới là kết quả của việc trừ một số phút nhất định vào một ngày.

• {{subMinutes(08-12-2025 15:55:20, 2)}} = 08-12-2025 15:53:20

{{subHours(date, number)}}

Trả về một ngày mới là kết quả của việc trừ một số giờ nhất định vào một ngày.

• {{subHours(08-12-2025 15:55:20, 2)}} = 08-12-2025 13:55:20

{{subDays(date, number)}}

Trả về một ngày mới là kết quả của việc trừ một số ngày nhất định vào một ngày.

• {{subDays(08-12-2025 15:55:20, 2)}} = 06-12-2025 15:55:20

{{subMonths(date, number)}}

Trả về một ngày mới là kết quả của việc trừ một số tháng nhất định vào một ngày.

• {{subMonths(08-12-2025 15:55:20, 2)}} = 08-10-2025 15:55:20

{{subYears(date, years)}}

Trả về một ngày mới là kết quả của việc trừ một số năm nhất định vào một ngày.

• {{subYears(08-12-2025 15:55:20, 2)}} = 08-12-2023 15:55:20

{{setSecond(date, number)}}

Trả về một ngày mới với giây được chỉ định trong tham số. Chấp nhận số từ 0 đến 59. Nếu một số được đưa ra ngoài phạm vi này, nó sẽ trả về ngày với giây từ phút trước hoặc sau đó.

• {{setSecond(08-12-2025 11:36:39, 10)}} = 08-12-2025 11:36:10

• {{setSecond(08-12-2025 11:36:39, 61)}} = 08-12-2025 11:37:01

{{setMinute(date, number)}}

Trả về một ngày mới với phút được chỉ định trong tham số. Chấp nhận số từ 0 đến 59. Nếu một số được đưa ra ngoài phạm vi này, nó sẽ trả về ngày với phút từ giờ trước hoặc sau đó.

• {{setMinute(08-12-2025 11:36:39, 10)}} = 08-12-2025 11:10:39

• {{setMinute(08-12-2025 11:36:39, 61)}} = 08-12-2025 12:01:39

{{setHour(date, number)}}

Trả về một ngày mới với giờ được chỉ định trong tham số. Chấp nhận số từ 0 đến 59. Nếu một số được đưa ra ngoài phạm vi này, nó sẽ trả về ngày với giờ từ ngày trước hoặc sau đó.

• {{setHour(08-12-2025 11:36:39, 10)}} = 08-12-2025 10:36:39

• {{setHour(08-12-2025 11:36:39, 10)}} = 09-12-2025 01:36:39

{{setDay(date, number/name of the day in English)}}

Trả về một ngày mới với ngày được chỉ định trong tham số. Có thể được sử dụng để thiết lập ngày trong tuần, với Chủ nhật là 1 và Thứ bảy là 7. Nếu giá trị cho là từ 1 đến 7, ngày kết quả sẽ nằm trong tuần hiện tại (Chủ nhật đến Thứ bảy). Nếu một số được đưa ra ngoài phạm vi này, nó sẽ trả về ngày từ tuần trước hoặc sau đó.

• {{setDay(08-12-2025 11:36:39, tuesday)}} = 09-12-2025 11:36:39

• {{setDay(08-12-2025 11:36:39, 1)}} = 07-12-2025 11:36:39

• {{setDay(08-12-2025 11:36:39, 7)}} = 13-12-2025 11:36:39

{{setDate(date, number)}}

Trả về một ngày mới với ngày trong tháng được chỉ định trong tham số. Chấp nhận số từ 1 đến 31. Nếu một số được đưa ra ngoài phạm vi này, nó sẽ trả về ngày từ tháng trước hoặc sau đó.

• {{setDate(08-12-2025 11:36:39, 5)}} = 05-12-2025 11:36:39

• {{setDate(08-12-2025 11:36:39, 32)}} = 01-01-2026 11:36:39

{{setMonth(date, number/name of the month in English)}}

Trả về một ngày mới với tháng được chỉ định trong tham số. Chấp nhận số từ 1 đến 12. Nếu một số được đưa ra ngoài phạm vi này, nó sẽ trả về tháng trong năm trước hoặc sau đó.

• {{setMonth(08-12-2025 11:36:39, 5)}} = 08-05-2025 11:36:39

• {{setMonth(08-12-2025 11:36:39, 17)}} = 08-05-2026 11:36:39

• {{setMonth(08-12-2025 11:36:39, january )}} = 08-01-2025 11:36:39

{{setYear(date, number)}}

Trả về một ngày mới với năm được chỉ định trong tham số.

• {{setYear(08-12-2025 11:36:39, 2028)}} = 08-12-2028 11:36:39

Các mẫu ví dụ

Cách tính ngày thứ n của tuần trong tháng

Nếu bạn cần tính một ngày tương ứng với ngày thứ n trong tháng (ví dụ: Thứ Ba tuần đầu tiên, Thứ Sáu tuần thứ ba, v.v.), bạn có thể sử dụng công thức sau:

Bạn có thể dùng công thức sau:

{{setDay(date, ngày trong tuần, tuần thứ mấy)}}

• `{{setDay(08-12-2025 11:36:39, Monday, 3)}} = 15-12-2025 11:36:39

• `{{setDay(08-12-2025 11:36:39, Tuesday)}} = 09-12-2025 11:36:39

• date: Ngày tháng cụ thể. Để tính ngày thứ n trong tháng hiện tại, sử dụng biến NOW().

• {{setDay(NOW(), Tuesday)}}

Cách tính số ngày giữa hai ngày

Sử dụng công thức sau:

{{calculateDay(date1, date2)}}

Ví dụ: Nếu date1 là 01 tháng 1 năm 2025 và date2 là 10 tháng 1 năm 2025, công thức này sẽ trả về 9 (số ngày giữa hai ngày).

• {{calculateDay(01-01-2025, 10-01-2025)}} = 9

Cách chuyển đổi giây thành giờ, phút và giây

Sử dụng công thức sau:

{{convertSeconds(seconds, format)}}

Ví dụ: Nếu bạn có 3661 giây, công thức này sẽ trả về 1:1:1 (1 giờ, 1 phút, 1 giây).

• {{convertSeconds(3661, HH:mm:ss)}} = 01:01:01

• {{convertSeconds(7200)}} = 02:00:00

Lưu ý

Giá trị của seconds phải là loại số. Hàm này chỉ phù hợp nếu giá trị seconds nhỏ hơn 86400 (nhỏ hơn một ngày).

Hy vọng rằng những thông tin này sẽ hữu ích cho bạn trong việc làm việc với các chức năng ngày và giờ. Nếu bạn có thêm câu hỏi nào khác, hãy cho tôi biết.