كتلة الوظيفة 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.