Datetime Compare

تقوم هذه الدالة بمقارنة تاريخ/وقت محدد مع تاريخ/وقت مرجعي. يمكن بناء التاريخ المرجعي من أجزاء التاريخ/الوقت الفردية أو يُستخدم التاريخ/الوقت الحالي للنظام كقيمة افتراضية إذا تُركت الأجزاء فارغة. النتيجة هي قيمة منطقية بسيطة (TRUE/FALSE) يمكن استخدامها للتحكم بأجزاء أخرى من السيناريو.

📥 المدخلات

• Input Date (input)

  • زود سلسلة تاريخ/وقت كاملة بالصيغة YYYY-MM-DD HH:MM:SS للمقارنة.

• Year (input)

  • اختياري. زود سنة (YYYY). اتركه فارغًا لاستخدام السنة الحالية.

• Month (input)

  • اختياري. زود شهرًا (MM). اتركه فارغًا لاستخدام الشهر الحالي.

• Date (input)

  • اختياري. زود يومًا من الشهر (DD). اتركه فارغًا لاستخدام اليوم الحالي.

• Hour (input)

  • اختياري. زود ساعة (HH). اتركه فارغًا لاستخدام الساعة الحالية.

• Minute (input)

  • اختياري. زود دقيقة (MM). اتركها فارغة لاستخدام الدقيقة الحالية.

• Second (input)

  • اختياري. زود ثانية (SS). اتركها فارغة لاستخدام الثانية الحالية.

📤 المخرجات

• Boolean (output)

  • تُرجع TRUE أو FALSE بناءً على العلاقة المحددة بين Input Date والتاريخ/الوقت المرجعي المُجمع.

🕹️ عناصر التحكم

• Relation - قائمة منسدلة بخيارات المقارنة: ==, ~=, <, <=, >=, >

  • اختر كيف ستتم مقارنة التاريخين (مساوٍ، غير مساوٍ، أصغر، أصغر أو يساوي، أكبر أو يساوي، أكبر).

🎯 المزايا

• مقارنة سهلة بين تاريخ/وقت كامل وتاريخ/وقت مرجعي مُنشأ من أجزاءه.

• أجزاء التاريخ/الوقت المرجعية تستخدم قيم النظام الحالية افتراضيًا إذا تُركت فارغة.

• ناتج منطقي بسيط مناسب لتدفقات المنطق، تفعيل الإجراءات أو التسجيل.

⚙️ آلية التشغيل

• تستقبل البلوك سلسلة تاريخ/وقت كاملة في Input Date وتقوم ببناء التاريخ/الوقت المرجعي من المدخلات الجزئية (Year, Month, Date, Hour, Minute, Second).

• أي جزء يترك فارغًا يستخدم قيمة النظام الحالية لذلك الجزء.

• يقارن البلوك التاريخين باستخدام عنصر التحكم Relation المحدد ويصدر نتيجة منطقية.

📝 تعليمات الاستخدام

1. زود سلسلة تاريخ/وقت كاملة إلى Input Date بالصيغة YYYY-MM-DD HH:MM:SS.

2. اختياريًا املأ أيًا من الحقول Year, Month, Date, Hour, Minute, Second لتكوين مرجع مخصص. اترك الحقول فارغة لاستخدام قيم النظام الحالية لتلك الأجزاء.

3. اختر معامل المقارنة في القائمة المنسدلة Relation.

4. استخدم الإخراج المنطقي للتحكم بالمنطق، المشغلات أو بلوكات التسجيل.

💡 نصائح وحيل

• ادمجها مع Date-Time للحصول بسرعة على سلسلة التاريخ/الوقت الحالية وتمريرها إلى Input Date لفحوصات سريعة.

• استخدم Date-Time List إذا رغبت بتوريد كل أجزاء التاريخ/الوقت من قائمة معدّة مسبقًا بدلًا من المدخلات الفردية.

• استخدم String Input حتى يقوم المشغل بكتابة تاريخ/وقت مخصص وقت التشغيل.

• وصل المخرَج المنطقي إلى Logic Input أو بلوكات منطق أخرى (مثل And, Or) لبناء تدفقات تحكم مبنية على الزمن.

• سجّل المطابقات أو الأحداث بربط النتيجة إلى CSV Export أو Image Logger لأغراض التدقيق.

• استخدم Debug Input لفحص القيم الوسيطة أثناء بناء السيناريو.

🛠️ استكشاف الأخطاء وإصلاحها

• إذا تصرفت المقارنات بشكل غير متوقع، تأكد من أن Input Date يتطابق مع الصيغة المطلوبة YYYY-MM-DD HH:MM:SS.

• إذا تُركت مدخلات أجزاء الوقت فارغة، فإن البلوك يستخدم قيم النظام الحالية لتلك الأجزاء — تحقق أن هذا ما تريده.

• إذا كنت بحاجة لمقارنة على مستوى التاريخ فقط (تجاهل الوقت)، عيّن أجزاء الوقت إلى أصفار أو تأكد أن كلا الطرفين يستخدمان نفس دقة الزمن.