> 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/input-output/data-inputs/date-time-list.md).

# Date-Time List

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

## 📥 المدخلات

هذه الدالة لا تحتوي على أي مدخلات.

## 📤 المخرجات

* `Year` — السنة الحالية كنص (مثال: 2026)
* `Month` — الشهر الحالي كنص مع صفر بادئ (مثال: 01..12)
* `Day` — اليوم من الشهر كنص مع صفر بادئ (مثال: 01..31)
* `Hour` — الساعة بنظام 24 ساعة كنص (مثال: 00..23)
* `Minute` — الدقيقة الحالية كنص (مثال: 00..59)
* `Second` — الثانية الحالية كنص (مثال: 00..59)
* `Milliseconds` — القيمة الدقيقة لما دون الثانية كنص (microseconds/milliseconds)

جميع المخرجات نصية وجاهزة للدمج في أسماء الملفات، الواجهات المرسومة على الصورة، أو السجلات.

## 🕹️ الضوابط

* `Current Date` — وسم للقراءة فقط يعرض التاريخ/الوقت الحالي لمعاينة سريعة
* `See Live Time` — منطقة نصية حية تعرض آخر طابع زمني (تتحدّث عند تشغيل السيناريو)

هذه عناصر عرض لمساعدتك في التحقق البصري من الوقت أثناء تشغيل السيناريو.

## 🎨 الخصائص

* قيم في الوقت الحقيقي: يتم تحديث المخرجات في كل تشغيل للحصول على طوابع زمنية محدثة.
* دقة ما دون الثانية: مفيد عندما تحتاج دقة زمنية عالية.
* مخرجات نصية: سهلة الدمج مع كتل نصية أخرى لتشكيل أسماء ملفات أو عناوين على الصور.
* لا حاجة لإعدادات: اسقط البلوك في التدفق واستخدم المخرجات مباشرة.

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

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

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

1. ضع البلوك في سير عملك. لا توجد مدخلات مطلوبة.
2. وصل أي مخرج تحتاجه (مثلاً اجمع `Year` و`Month` و`Day` معًا لبناء سلسلة تاريخ).
3. استخدم كتلًا أخرى لتنسيق أو حفظ البيانات ذات الطابع الزمني (انظر النصائح لطرق شائعة للدمج).

## 💡 نصائح وحيل

* لكتابة التاريخ/الوقت على صورة للسجلات البصرية، ادمج هذا البلوك مع `Write Date On Image` أو `Write Text On Image`.
* لحفظ الصور بأسماء ملفات تحتوي على طابع زمني، ادمج مخرجات التاريخ/الوقت في اسم ملف باستخدام `String Merge` ثم مرّرها إلى `Image Logger` أو `Image Write`.
* لتأريخ تسجيلات الفيديو، مرّر المخرجات النصية إلى مدخل `File Name` في `Record Video` حتى تُسمّى كل عملية تسجيل بحسب وقت البدء.
* لإنشاء سجلات مؤرخة (CSV أو JSON)، ادمج المخرجات مع `Data to JSON or CSV Export`.
* لتشغيل إجراءات في أوقات محددة، استخدم `Datetime Compare` مع كتل منطقية مثل `Rising Edge` أو `Logic Input` لبناء فحوصات وTriggers بسيطة.
* للمراجعة البصرية السريعة أثناء التطوير، اعرض الصور في `Show Image` بعد وضع النص باستخدام `Write Text On Image`.

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

* إذا ظهرت طوابع زمنية غير صحيحة، تحقق من ساعة النظام وإعدادات المنطقة الزمنية على جهاز الكمبيوتر.
* إذا احتجت تنسيقًا مختلفًا (مثلاً بدون أصفار بادئة أو بصيغة 12 ساعة)، استخدم كتل `String Operations` أو `String Merge` لإعادة تنسيق المخرجات النصية قبل الاستخدام.