> 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.md).

# Date-Time

يوفر هذا البلوك (function block) التاريخ والوقت الحالي كسلسلة نصية قابلة للقراءة. يمكنك الاختيار بين عدة صيغ شائعة وأيضًا صيغة صالحة للاستخدام في أسماء الملفات عند الحفظ.

## 📥 المدخلات

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

## 📤 المخرجات

`Text` — التاريخ والوقت الحالي كسلسلة نصية منسقة وفقًا للخيار المحدد.

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

`Format` — Combobox لاختيار صيغة الإخراج. الخيارات الشائعة تتضمن:

* Standard (YYYY-MM-DD HH:MM:SS)
* Milliseconds (YYYY-MM-DD HH:MM:SS.sss)
* Iso Format (ISO 8601)

`File Name Mode` — Combobox لاختيار نمط مناسب لاسم الملف. الخيارات تتضمن:

* Standard (human-readable string)
* File Name (يستبدل أحرف مثل ":" والمسافات بحيث يمكن استخدام السلسلة كاسم ملف أو مجلد)

## 🎨 الميزات

* دعم صيغ تاريخ/وقت متعددة لتلبية احتياجات مختلفة (نص قابل للقراءة، طوابع زمنية بدقة عالية، أو معيار ISO).
* خيار خاص بأسماء الملفات يحول التاريخ/الوقت إلى صيغة آمنة للاستخدام كاسم ملف بدون معالجة إضافية.
* عملية بسيطة بدون مدخلات — يقوم بإرجاع وقت النظام الحالي عند كل تقييم.

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

1. اختر صيغة الإخراج المطلوبة باستخدام التحكم `Format`.
2. إذا كنت ستستخدم المخرجات كجزء من اسم ملف (لحفظ صور، سجلات، أو فيديو)، فعِّل `File Name Mode` للحصول على سلسلة آمنة للاسم.
3. اربط مخرج `Text` بالبلوكات اللاحقة التي تحتاج معلومات الوقت (لتسمية الملفات، التسجيلات، أو التعليقات).

## 📊 التقييم

عند كل تشغيل، يقرأ هذا البلوك ساعة النظام ويخرج سلسلة منسقة وفق إعدادات `Format` و`File Name Mode`.

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

* استخدم البلوك مع `Image Write` أو `Image Logger` لحفظ الصور بأسماء تحتوي على الطابع الزمني. اختيار `File Name` سيتجنب تلقائيًا الأحرف غير المسموح بها في أسماء الملفات.
* ادمجه مع `Record Video` عند إنشاء تسجيلات موسومة زمنيًا لتنظيم الملفات حسب وقت التشغيل.
* اقتران مع `CSV Export` أو `Data to JSON` لإضافة طابع زمني قابل للقراءة إلى صفوف البيانات أو السجلات المصدّرة.
* إذا احتجت مكونات منفصلة للتاريخ/الوقت (سنة، شهر، ساعة، إلخ) لأغراض منطقية أو عرض، استخدم `Date-Time List` حيثما كان متاحًا للحصول على عناصر مُهيكلة بدلاً من سلسلة واحدة.
* استخدم `String Merge` لدمج الطابع الزمني مع نص آخر (مثل معرف الكاميرا أو اسم التجربة) قبل الكتابة باستخدام `File/Folder Operations` أو `Choose Folder`.

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

* إذا تسببت أسماء الملفات المولدة بالطابع الزمني بأخطاء عند الحفظ، غيّر وضع `File Name Mode` إلى `File Name` لإزالة أو استبدال الأحرف غير المسموح بها في أسماء الملفات.
* إذا كنت بحاجة إلى دقة أعلى لأحداث قصيرة المدة، اختر صيغة `Milliseconds`.
* إذا كانت البلوكات اللاحقة تتوقع صيغة طابع زمني محددة، تأكد أن `Format` المختار يتطابق مع تلك التوقعات وعدّله عند الضرورة.