เนื้อหาในหน้านี้

> ทรัพยากร > เอกสาร > นิพจน์ > ฟังก์ชันวันที่และเวลา

ฟังก์ชันวันที่และเวลา

ฟังก์ชันสำหรับดึงส่วนประกอบของวันที่และเวลา รวมถึงคำนวณวันที่และเวลา.

การทำงานกับ Timestamp

ใน ProcessMind ระบบจัดเก็บ timestamp เป็นตัวเลขที่ระบุจำนวนมิลลิวินาทีตั้งแต่วันที่ 1 มกราคม 1970 (Unix epoch) ฟังก์ชันวันที่จะทำงานกับค่า timestamp เหล่านี้.

รูปแบบที่ใช้บ่อย

ดึงส่วนของวันที่:

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

คำนวณระยะเวลา:

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

สร้างช่วงเวลา:

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

เพิ่มเวลาให้วันที่:

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

now

()

คืนค่าเวลา UTC ปัจจุบันในรูปแบบ timestamp หน่วยมิลลิวินาทีที่นับจาก Unix epoch.

ค่าที่ส่งกลับ	`ตัวเลข`
ตัวอย่าง	`now()` → `1708963200000` timestamp ปัจจุบัน

year

(timestamp)

ดึงปีจาก timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

year(StartTime) → 2024

ดูเพิ่มเติม

เดือน วัน quarter

month

(timestamp)

ดึงเดือน (1-12) จาก timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

month(StartTime) → 3

March

ดูเพิ่มเติม

ปี วัน monthName

day

(timestamp)

ดึงวันที่ของเดือน (1-31) จาก timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

day(StartTime) → 18

ดูเพิ่มเติม

ปี เดือน dayOfWeek

hour

(timestamp)

ดึงชั่วโมง (0-23) จาก timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

hour(StartTime) → 14

2 PM

ดูเพิ่มเติม

นาที second

minute

(timestamp)

ดึงนาที (0-59) จาก timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

minute(StartTime) → 30

ดูเพิ่มเติม

ชั่วโมง second

second

(timestamp)

ดึงวินาที (0-59) จาก timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

second(StartTime) → 45

ดูเพิ่มเติม

ชั่วโมง นาที

dayOfWeek

(timestamp)

คืนวันในสัปดาห์จากค่า timestamp โดย 1 คือวันจันทร์ และ 7 คือวันอาทิตย์.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

dayOfWeek(StartTime) → 1

วันจันทร์

ดูเพิ่มเติม

dayName วัน

dayName

(timestamp)

คืนชื่อวันในสัปดาห์จากค่า timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ สตริง

ตัวอย่าง

dayName(StartTime) → วันจันทร์

ดูเพิ่มเติม

dayOfWeek monthName

monthName

(timestamp)

คืนชื่อเดือนจากค่า timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ สตริง

ตัวอย่าง

monthName(StartTime) → มีนาคม

ดูเพิ่มเติม

เดือน dayName

quarter

(timestamp)

คืนไตรมาส (1-4) จากค่า timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

quarter(StartTime) → 1

ไตรมาส 1 (ม.ค.-มี.ค.)

ดูเพิ่มเติม

ปี เดือน

weekOfYear

(timestamp)

คืนหมายเลขสัปดาห์ตามมาตรฐาน ISO (1-53) จากค่า timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

weekOfYear(StartTime) → 12

สัปดาห์ที่ 12 ของปี 2024

ดูเพิ่มเติม

dayOfYear ปี

dayOfYear

(timestamp)

คืนลำดับวันในปี (1-366) จากค่า timestamp.

พารามิเตอร์

timestamp number ค่า timestamp

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

dayOfYear(StartTime) → 78

วันที่ 78 ของปี (18 มีนาคม 2024)

ดูเพิ่มเติม

weekOfYear วัน

dateAdd

(timestamp, amount, unit)

เพิ่มระยะเวลาตามที่กำหนดให้กับค่า timestamp.

พารามิเตอร์

timestamp	`number`	ค่า timestamp เริ่มต้น
amount	`number`	ระยะเวลาที่ต้องการเพิ่ม ระบุเป็นค่าติดลบได้
unit	`string`	หน่วย: 'year', 'month', 'day', 'hour', 'minute', 'second'

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

dateAdd(StartTime, 7, "day") → timestamp + 7 วัน

dateAdd(StartTime, -1, "month") → timestamp - 1 เดือน

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

เพิ่ม 1 วันจากวันที่ 18 มีนาคม 2024

ดูเพิ่มเติม

dateDiff

(startTimestamp, endTimestamp, unit)

คำนวณผลต่างระหว่างค่า timestamp สองค่าในหน่วยที่กำหนด.

พารามิเตอร์

startTimestamp	`number`	เวลาเริ่มต้น
endTimestamp	`number`	ค่า timestamp สิ้นสุด
unit	`string`	หน่วย: 'day', 'hour', 'minute', 'second'

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

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

ระยะเวลาเป็นนาที

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

หมายเหตุ

คืนค่าทศนิยมที่แสดงผลต่างอย่างแม่นยำ.

ดูเพิ่มเติม

dateAdd

isBusinessDay

(timestamp)

ตรวจสอบว่า timestamp ตรงกับวันทำการหรือไม่ (วันจันทร์ถึงวันศุกร์).

พารามิเตอร์

timestamp number ค่า timestamp ที่ต้องการตรวจสอบ

ค่าที่ส่งกลับ ค่าบูลีน

ตัวอย่าง

isBusinessDay(StartTime) → true

หาก StartTime ตรงกับวันธรรมดา

ดูเพิ่มเติม

workingDaysBetween dayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

นับวันทำการ (วันจันทร์ถึงวันศุกร์) ระหว่าง timestamp สองค่า.

พารามิเตอร์

startTimestamp	`number`	เวลาเริ่มต้น
endTimestamp	`number`	ค่า timestamp สิ้นสุด

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

workingDaysBetween(StartTime, EndTime) → จำนวนวันธรรมดาระหว่างวันที่ทั้งสอง

workingDaysBetween(1710766245000, 1711371045000) → 5

มีวันทำการ 5 วันระหว่างวันจันทร์ที่ 18 มี.ค. และวันจันทร์ที่ 25 มี.ค. 2024

หมายเหตุ

ฟังก์ชันช่วยคำนวณโดยประมาณสำหรับระบบหลังบ้านหรือปฏิทินวันทำการ ไม่นับวันหยุดนักขัตฤกษ์ โดยนับเฉพาะวันสุดสัปดาห์.

ดูเพิ่มเติม

isBusinessDay dateDiff

toUtc

(timestamp, offsetHours)

แปลง timestamp ตามเวลาท้องถิ่นเป็น UTC โดยลบส่วนต่างเขตเวลาออก.

พารามิเตอร์

timestamp	`number`	ค่า timestamp ตามเวลาท้องถิ่น
offsetHours	`number`	ส่วนต่างเขตเวลาเป็นชั่วโมง

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

toUtc(StartTime, 2) → StartTime - 2 ชั่วโมง

แปลงจาก UTC+2

toUtc(1710766245000, 2) → 1710759045000

แปลง timestamp จาก UTC+2 เป็น UTC

หมายเหตุ

ขณะนี้การแปลงเขตเวลารองรับเฉพาะส่วนต่าง UTC ที่ระบุเป็นตัวเลขชั่วโมง ยังไม่รองรับชื่อเขตเวลา IANA.

ดูเพิ่มเติม

toLocal convertTimezone

toLocal

(timestamp, offsetHours)

แปลง timestamp จาก UTC เป็นเวลาท้องถิ่นโดยบวกส่วนต่างเขตเวลา.

พารามิเตอร์

timestamp	`number`	ค่า timestamp ใน UTC
offsetHours	`number`	ส่วนต่างเขตเวลาเป็นชั่วโมง

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

toLocal(StartTime, -5) → StartTime - 5 ชั่วโมง

แปลงเป็น EST

toLocal(1710766245000, -5) → 1710748245000

แปลง timestamp จาก UTC เป็น EST (UTC-5)

หมายเหตุ

ดูเพิ่มเติม

toUtc convertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

แปลง timestamp จากเขตเวลาหนึ่งไปยังอีกเขตเวลาหนึ่ง.

พารามิเตอร์

timestamp	`number`	ค่า timestamp ที่ต้องการแปลง
fromOffset	`number`	ส่วนต่างเขตเวลาต้นทางเป็นชั่วโมง
toOffset	`number`	ส่วนต่างเขตเวลาปลายทางเป็นชั่วโมง

ค่าที่ส่งกลับ ตัวเลข

ตัวอย่าง

convertTimezone(StartTime, 1, -5) → timestamp ที่ปรับเวลาแล้ว -6 ชั่วโมง

CET เป็น EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

แปลงจาก UTC+1 เป็น UTC-5

หมายเหตุ

ดูเพิ่มเติม

toUtc toLocal

หัวข้อที่เกี่ยวข้อง

ภาพรวม Expressions: รวมฟังก์ชัน expression ทั้งหมด.

ออกแบบกระบวนการให้ดีขึ้น วางโครงสร้างที่เชื่อมโยงกัน และควบคุมได้.

เริ่มใช้งานได้ทันที ไม่ต้องใช้บัตรเครดิตและไม่ต้องรอ เปลี่ยนวิธีทำงานขององค์กรให้เป็นแบบจำลองกระบวนการที่ชัดเจนและเชื่อมโยงกัน.

สร้างสถาปัตยกรรมกระบวนการ กำหนดเจ้าของและการควบคุม พร้อมจัดบทบาทและความรับผิดชอบให้สอดคล้องกันในทุกระดับ.

เริ่มทดลองใช้ฟรี แล้วสร้างรากฐานที่เชื่อถือได้สำหรับกำกับดูแล จัดการ และปรับปรุงกระบวนการอย่างต่อเนื่อง.

เริ่มทดลองใช้ฟรีวันนี้