كتلة الوظيفة TIMESWITCH_ADD

تخلق كتلة الوظيفة TIMESWITCH_ADD أو تعدل حدثًا في ساعة زمنية.

ملاحظة: يجب تخزين ساعة الزمنية في نفس العنصر.

نصيحة: يمكن قراءة جميع القيم لتعديل الحدث باستخدام كتلة الوظيفة TIMESWITCH_GET.

مدخل ADD

يخلق المدخل أو يعدل حدثًا في التقويم عند حافة إيجابية. إذا كان المدخل دائمًا صحيحًا، فسيتم إنشاء الحدث مرة أخرى بمجرد حذفه. لن يتم اكتشاف أي تعديلات على الحدث.

هام: يجب تجنب إنشاء وحذف الحدث في نفس الوقت، حيث يمكن أن يضر ذلك بشكل كبير بالـ SSD.

مدخل TIMESWITCH

هنا يتم تخزين قاعدة بيانات ساعة الزمنية كسلسلة من الرموز. يجب أن تكون هذه موجودة بالفعل ككتلة وظيفية TIMESWITCH. يرجى مراعاة أيضًا ترتيب البرنامج لضمان تهيئة هذه الكتلة الوظيفة بشكل صحيح.

مدخل ID

يحدد المعرف كسلسلة من الرموز للحدث. هذا يتيح تحديدًا فريدًا ويمنع حدوث تعارضات مع أحداث أخرى. يجب أن يتكون المعرف فقط من حروف وأرقام. يتم مراعاة الحروف الكبيرة والصغيرة.

ملاحظة: يجب تعريف المعرف بشكل فريد لجميع التقاويم. يمكن للمستخدم نسخ حدث إلى تقويم آخر في التصفح البصرية.

مدخل TITLE

العنوان للحدث كسلسلة من الرموز. يجب أن لا يحتوي على تغييرات في السطر. إذا كان المدخل ADD صحيحًا، فسيتم كتابة أي تعديل فورًا في التقويم.

مدخل DT_START

وقت البدء للحدث في تنسيق DT#. إذا كان المدخل ADD صحيحًا، فسيتم كتابة أي تعديل فورًا في التقويم.

نصيحة: يمكن حساب أوقات التبديل باستخدام الكتل الوظيفية MKTIME، STR2DT وEASTER_DATE.

مدخل DT_END

وقت الانتهاء للحدث في تنسيق DT#. إذا كان المدخل ADD صحيحًا، فسيتم كتابة أي تعديل فورًا في التقويم. إذا كان وقت الانتهاء أصغر من DT_START، فسيتم تعريف DT_END كوقت البدء.

إذا لم يتم تحديد المدخل، فسيتم افتراض نفس القيمة مثل DT_START وسيتم إنشاء نبضة للحدث.

مدخل DIS

يعدل المدخل الحدث في التقويم. إذا كان المدخل ADD صحيحًا، فسيتم كتابة أي تعديل فورًا في التقويم.

مدخل 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	يتكرر في رابع يوم من الأسبوع.

مخرج ERR

في حالة الخطأ، يتم تعيين المخرج على صحيح. يمكن أن يحدث ذلك إذا لم يكن التقويم موجودًا أو تم تحديد المعرف بشكل غير صالح أو غير محدد.