> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/data-logic/data-operations/datetime-compare.md).

# Datetime Compare

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

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

* `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). اتركها فارغة لاستخدام الثانية الحالية.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

* `Boolean` (output)
  * تُرجع TRUE أو FALSE بناءً على العلاقة المحددة بين `Input Date` والتاريخ/الوقت المرجعي المُجمع.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

* `Relation` - قائمة منسدلة بخيارات المقارنة: `==`, `~=`, `<`, `<=`, `>=`, `>`
  * اختر كيف ستتم مقارنة التاريخين (مساوٍ، غير مساوٍ، أصغر، أصغر أو يساوي، أكبر أو يساوي، أكبر).

## 🎯 المزايا <a href="#features" id="features"></a>

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

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* تستقبل البلوك سلسلة تاريخ/وقت كاملة في `Input Date` وتقوم ببناء التاريخ/الوقت المرجعي من المدخلات الجزئية (`Year`, `Month`, `Date`, `Hour`, `Minute`, `Second`).
* أي جزء يترك فارغًا يستخدم قيمة النظام الحالية لذلك الجزء.
* يقارن البلوك التاريخين باستخدام عنصر التحكم `Relation` المحدد ويصدر نتيجة منطقية.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. زود سلسلة تاريخ/وقت كاملة إلى `Input Date` بالصيغة YYYY-MM-DD HH:MM:SS.
2. اختياريًا املأ أيًا من الحقول `Year`, `Month`, `Date`, `Hour`, `Minute`, `Second` لتكوين مرجع مخصص. اترك الحقول فارغة لاستخدام قيم النظام الحالية لتلك الأجزاء.
3. اختر معامل المقارنة في القائمة المنسدلة `Relation`.
4. استخدم الإخراج المنطقي للتحكم بالمنطق، المشغلات أو بلوكات التسجيل.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* ادمجها مع `Date-Time` للحصول بسرعة على سلسلة التاريخ/الوقت الحالية وتمريرها إلى `Input Date` لفحوصات سريعة.
* استخدم `Date-Time List` إذا رغبت بتوريد كل أجزاء التاريخ/الوقت من قائمة معدّة مسبقًا بدلًا من المدخلات الفردية.
* استخدم `String Input` حتى يقوم المشغل بكتابة تاريخ/وقت مخصص وقت التشغيل.
* وصل المخرَج المنطقي إلى `Logic Input` أو بلوكات منطق أخرى (مثل `And`, `Or`) لبناء تدفقات تحكم مبنية على الزمن.
* سجّل المطابقات أو الأحداث بربط النتيجة إلى `CSV Export` أو `Image Logger` لأغراض التدقيق.
* استخدم `Debug Input` لفحص القيم الوسيطة أثناء بناء السيناريو.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا تصرفت المقارنات بشكل غير متوقع، تأكد من أن `Input Date` يتطابق مع الصيغة المطلوبة YYYY-MM-DD HH:MM:SS.
* إذا تُركت مدخلات أجزاء الوقت فارغة، فإن البلوك يستخدم قيم النظام الحالية لتلك الأجزاء — تحقق أن هذا ما تريده.
* إذا كنت بحاجة لمقارنة على مستوى التاريخ فقط (تجاهل الوقت)، عيّن أجزاء الوقت إلى أصفار أو تأكد أن كلا الطرفين يستخدمان نفس دقة الزمن.