ฟังก์ชันบล็อก TIMESWITCH_GET

ฟังก์ชันบล็อก TIMESWITCH_GET ให้ข้อมูลทั้งหมดของเหตุการณ์ของนาฬิกาเวลา

หมายเหตุ: นาฬิกาเวลา ต้องอยู่ในองค์ประกอบเดียวกัน

อินพุต TIMESWITCH

ที่นี่จะเก็บฐานข้อมูลของนาฬิกาเวลาออกมาเป็นสตริง ให้มีการตั้งค่าฟังก์ชันบล็อก TIMESWITCH อยู่แล้ว คุณต้องดูการเรียงลำดับของโปรแกรมด้วย เพื่อให้ฟังก์ชันบล็อกนี้ถูกกำหนดค่าเริ่มต้นอย่างถูกต้อง

อินพุต ID

กำหนดไอดีเป็นสตริงของเหตุการณ์

เอาต์พุต ERR

ในกรณีเกิดข้อผิดพลาด ออกพุตจะถูกตั้งค่าเป็นจริง เนื่องจากปฏิทินไม่มีอยู่หรือไอดีไม่ได้ถูกกำหนด หรือไม่ถูกต้อง

เอาต์พุต TITLE

ให้ชื่อของเหตุการณ์กลับมา

เอาต์พุต DT_START

เวลาที่เริ่มต้นของเหตุการณ์ในรูปแบบ DT# กลับมา

เอาต์พุต DT_END

เวลาสิ้นสุดของเหตุการณ์ในรูปแบบ DT# กลับมา

เอาต์พุต DIS

ถ้าออกพุตเป็นจริง เหตุการณ์นั้นจะถูกปิดใช้งานและโปรแกรมเวลาจะไม่สนใจเหตุการณ์นี้

เอาต์พุต REPEAT

ออกพุตให้ค่าการซ้ำเป็นสตริง ค่านี้ตรงกับฟังก์ชันช่วยเหลือ REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY และ REPEAT_HOURLY

สตริงนี้สามารถแยกด้วยเครื่องหมายสองจุด หรือมีโครงสร้างดังต่อไปนี้:

w:2:4:135

ตัวเลขตัวแรก (พิมพ์เล็ก) กำหนดช่วงเวลาของการซ้ำ:

สัญลักษณ์ย่อ	ช่วงเวลา
h	ทุกชั่วโมง
d	ทุกวัน
w	ทุกสัปดาห์
m	ทุกเดือน
y	ทุกปี

ตัวเลขที่สองกำหนดช่วงเวลาของการซ้ำเป็นจำนวนเต็ม ค่าที่น้อยที่สุดคือ 1

ตัวเลขที่สามกำหนดการสิ้นสุดของการซ้ำ มีสามรูปแบบที่แตกต่างกันที่สามารถกำหนดได้:

• ไม่มีค่า: การซ้ำเป็นอันดับสูงสุด
• เป็นจำนวนเต็มอย่างง่าย: การซ้ำจะสิ้นสุดหลังจากจำนวนการซ้ำที่กำหนด
• เป็นวันที่ YYYY-MM-DD: การซ้ำจะสิ้นสุดก่อนวันที่นั้น

ตัวเลขที่สี่กำหนดวันในสัปดาห์ที่เกิดการซ้ำขึ้นนี้ ตัวเลขนี้ใช้เพียงในการกำหนดการซ้ำรายสัปดาห์หรือรายเดือนเท่านั้น

การซ้ำรายสัปดาห์

ตรวจสอบว่าวันในสัปดาห์ปัจจุบันอยู่ในตัวเลขนี้ได้หรือไม่ วันหลายวันสามารถระบุได้โดยการใส่ต่อกัน เช่น 135 สำหรับวันจันทร์ วันพุธ และวันศุกร์ ถ้าค่าไม่ถูกกำหนด (0 หรือสตริงว่าง) การซ้ำจะไม่เกิดขึ้นในวันใดๆ

ตัวเลข	วันในสัปดาห์
1	วันจันทร์
2	วันอังคาร
3	วันพุธ
4	วันพฤหัสบดี
5	วันศุกร์
6	วันเสาร์
7	วันอาทิตย์

การซ้ำรายเดือน

กำหนดว่าหลังจากวันในสัปดาห์ใดเหตุการณ์จะถูกซ้ำ ให้ใช้ตัวเลขตั้งแต่ -1 ถึง 4 0 หรือไม่มีการประกาศจะซ้ำทุกเดือนในวันเดียวกัน ไม่ขึ้นอยู่กับวันในสัปดาห์ วันในสัปดาห์จะถูกนำมาจากวันที่แรก

ค่า	คำอธิบาย
-1	ซ้ำในวันสุดท้ายของสัปดาห์
0	ซ้ำในวันเดียวกัน (ค่าเริ่มต้น)
1	ซ้ำในวันแรกของสัปดาห์
2	ซ้ำในวันที่สองของสัปดาห์
3	ซ้ำในวันที่สามของสัปดาห์
4	ซ้ำในวันที่สี่ของสัปดาห์

เอาต์พุต DT_MODIFY

ออกพุตกำหนดการแก้ไขล่าสุดในรูปแบบ DT# อินพุตนี้อาจไม่ได้ถูกกำหนดหากเหตุการณ์นั้นสร้างขึ้นก่อนเวอร์ชัน 5.0