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 المختار يتطابق مع تلك التوقعات وعدّله عند الضرورة.