Trong trang này

> tai nguyen > tai lieu > bieu thuc > Hàm ngày và giờ

Hàm ngày và giờ

Các hàm trích xuất thành phần ngày giờ và thực hiện phép tính ngày tháng.

Làm việc với dấu thời gian

Trong ProcessMind, dấu thời gian được lưu dưới dạng số, thể hiện số mili giây kể từ ngày 1 tháng 1 năm 1970 (Unix epoch). Các hàm ngày tháng sử dụng những giá trị dấu thời gian này.

Các mẫu thường dùng

Trích xuất thành phần ngày:

year(StartTime)       // 2024
month(StartTime)      // 3 (March)
day(StartTime)        // 15

Tính thời lượng:

dateDiff(StartTime, EndTime, "minute")
dateDiff(StartTime, EndTime, "hour")
dateDiff(StartTime, EndTime, "day")

Tạo nhóm thời gian:

bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening")

Cộng thời gian vào ngày:

dateAdd(StartTime, 7, "day")     // Add 7 days
dateAdd(StartTime, -1, "month")  // Subtract 1 month

now

()

Trả về dấu thời gian UTC hiện tại, tính bằng mili giây kể từ mốc Unix.

Giá trị trả về	`number`
Ví dụ	`now()` → `1708963200000` Dấu thời gian hiện tại

year

(timestamp)

Lấy năm từ dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

year(StartTime) → 2024

Xem thêm

month day quarter

month

(timestamp)

Lấy tháng (1-12) từ dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

month(StartTime) → 3

Tháng 3

Xem thêm

year day monthName

day

(timestamp)

Lấy ngày trong tháng (1-31) từ dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

day(StartTime) → 18

Xem thêm

year month dayOfWeek

hour

(timestamp)

Lấy giờ (0-23) từ dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

hour(StartTime) → 14

2 giờ chiều

Xem thêm

minute second

minute

(timestamp)

Lấy phút (0-59) từ dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

minute(StartTime) → 30

Xem thêm

hour second

second

(timestamp)

Lấy giây (0-59) từ dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

second(StartTime) → 45

Xem thêm

hour minute

dayOfWeek

(timestamp)

Trả về thứ trong tuần của một dấu thời gian, trong đó 1 là thứ Hai và 7 là Chủ nhật.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

dayOfWeek(StartTime) → 1

Thứ Hai

Xem thêm

dayName day

dayName

(timestamp)

Trả về tên thứ trong tuần của một dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về string

Ví dụ

dayName(StartTime) → Thứ Hai

Xem thêm

dayOfWeek monthName

monthName

(timestamp)

Trả về tên tháng của một dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về string

Ví dụ

monthName(StartTime) → Tháng Ba

Xem thêm

month dayName

quarter

(timestamp)

Trả về quý (1-4) của một dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

quarter(StartTime) → 1

Quý 1 (tháng 1-3)

Xem thêm

year month

weekOfYear

(timestamp)

Trả về số tuần ISO (1-53) của một dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

weekOfYear(StartTime) → 12

Tuần 12 năm 2024

Xem thêm

dayOfYear year

dayOfYear

(timestamp)

Trả về ngày thứ mấy trong năm (1-366) của một dấu thời gian.

Tham số

timestamp number Giá trị dấu thời gian

Giá trị trả về number

Ví dụ

dayOfYear(StartTime) → 78

Ngày thứ 78 trong năm (18 tháng 3 năm 2024)

Xem thêm

weekOfYear day

dateAdd

(timestamp, amount, unit)

Cộng một khoảng thời gian chỉ định vào dấu thời gian.

Tham số

timestamp	`number`	Dấu thời gian bắt đầu
amount	`number`	Khoảng thời gian cần cộng, có thể là số âm
unit	`string`	Đơn vị: 'year', 'month', 'day', 'hour', 'minute', 'second'

Giá trị trả về number

Ví dụ

dateAdd(StartTime, 7, "day") → dấu thời gian + 7 ngày

dateAdd(StartTime, -1, "month") → dấu thời gian - 1 tháng

dateAdd(1710766245000, 1, "day") → 1710852645000

Cộng 1 ngày vào ngày 18 tháng 3 năm 2024

Xem thêm

dateDiff

(startTimestamp, endTimestamp, unit)

Tính khoảng chênh lệch giữa hai dấu thời gian theo đơn vị chỉ định.

Tham số

startTimestamp	`number`	Dấu thời gian bắt đầu
endTimestamp	`number`	Dấu thời gian kết thúc
unit	`string`	Đơn vị: 'day', 'hour', 'minute', 'second'

Giá trị trả về number

Ví dụ

dateDiff(StartTime, EndTime, "minute") → 150

Thời lượng tính bằng phút

dateDiff(StartTime, EndTime, "hour") → 2.5

Ghi chú

Trả về giá trị thập phân biểu thị chính xác khoảng chênh lệch.

Xem thêm

dateAdd

isBusinessDay

(timestamp)

Kiểm tra xem dấu thời gian có rơi vào ngày làm việc (từ thứ Hai đến thứ Sáu) hay không.

Tham số

timestamp number Dấu thời gian cần kiểm tra

Giá trị trả về boolean

Ví dụ

isBusinessDay(StartTime) → true

True nếu StartTime rơi vào ngày trong tuần

Xem thêm

workingDaysBetween dayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Đếm số ngày làm việc (từ thứ Hai đến thứ Sáu) giữa hai dấu thời gian.

Tham số

startTimestamp	`number`	Dấu thời gian bắt đầu
endTimestamp	`number`	Dấu thời gian kết thúc

Giá trị trả về number

Ví dụ

workingDaysBetween(StartTime, EndTime) → Số ngày trong tuần giữa hai ngày

workingDaysBetween(1710766245000, 1711371045000) → 5

5 ngày làm việc từ thứ Hai 18/03 đến thứ Hai 25/03/2024

Ghi chú

Hàm hỗ trợ ước tính cho lịch làm việc ở backend. Hàm không tính ngày lễ, chỉ loại trừ cuối tuần.

Xem thêm

isBusinessDay dateDiff

toUtc

(timestamp, offsetHours)

Chuyển dấu thời gian địa phương sang UTC bằng cách trừ độ lệch múi giờ.

Tham số

timestamp	`number`	Dấu thời gian địa phương
offsetHours	`number`	Độ lệch múi giờ tính bằng giờ

Giá trị trả về number

Ví dụ

toUtc(StartTime, 2) → StartTime - 2 giờ

Chuyển từ UTC+2

toUtc(1710766245000, 2) → 1710759045000

Chuyển dấu thời gian từ UTC+2 sang UTC

Ghi chú

Hiện tại, tính năng chuyển đổi múi giờ chỉ hỗ trợ độ lệch UTC dạng số theo giờ, không hỗ trợ tên múi giờ IANA.

Xem thêm

toLocal convertTimezone

toLocal

(timestamp, offsetHours)

Chuyển dấu thời gian UTC sang giờ địa phương bằng cách cộng độ lệch múi giờ.

Tham số

timestamp	`number`	Dấu thời gian UTC
offsetHours	`number`	Độ lệch múi giờ tính bằng giờ

Giá trị trả về number

Ví dụ

toLocal(StartTime, -5) → StartTime - 5 giờ

Chuyển sang EST

toLocal(1710766245000, -5) → 1710748245000

Chuyển dấu thời gian UTC sang EST (UTC-5)

Ghi chú

Hiện tại, tính năng chuyển đổi múi giờ chỉ hỗ trợ độ lệch UTC dạng số theo giờ, không hỗ trợ tên múi giờ IANA.

Xem thêm

toUtc convertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Chuyển dấu thời gian từ múi giờ này sang múi giờ khác.

Tham số

timestamp	`number`	Dấu thời gian cần chuyển đổi
fromOffset	`number`	Độ lệch múi giờ nguồn tính bằng giờ
toOffset	`number`	Độ lệch múi giờ đích tính bằng giờ

Giá trị trả về number

Ví dụ

convertTimezone(StartTime, 1, -5) → dấu thời gian được điều chỉnh -6 giờ

CET sang EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

Chuyển từ UTC+1 sang UTC-5

Ghi chú

Hiện tại, tính năng chuyển đổi múi giờ chỉ hỗ trợ độ lệch UTC dạng số theo giờ, không hỗ trợ tên múi giờ IANA.

Xem thêm

toUtc toLocal

Chủ đề liên quan

Tổng quan về biểu thức: tất cả hàm biểu thức.

Thiết kế quy trình tốt hơn. Kết nối các quy trình. Luôn chủ động kiểm soát.

Truy cập ngay, không cần thẻ tín dụng hay chờ đợi. Biến cách tổ chức của bạn vận hành thành các thiết kế quy trình rõ ràng, liên kết với nhau.

Xây dựng kiến trúc quy trình, xác định quyền sở hữu và cơ chế kiểm soát, đồng thời thống nhất vai trò và trách nhiệm ở mọi cấp.

Bắt đầu dùng thử miễn phí để tạo nền tảng đáng tin cậy cho việc quản trị, quản lý và cải tiến quy trình liên tục.

Dùng thử miễn phí ngay