تتوفر أمثلة على تعبيرات التقرير لأسئلة التاريخ والوقت والتاريخ أدناه.
ملاحظة:
هذه التعبيرات غير مدعومة لأسئلة الوقت التي يتم تخزينها على هيئة سلاسل نصية.
لضمان تقديم أسئلة التاريخ والتاريخ-الوقت بطريقة دقيقة بالنسبة إلى تنسيق منطقتك، يمكنك استخدام تعبير لتنسيق السؤال لمطابقة الإعدادات المحلية المتوفرة. ضع طريقة locale أولاً في التعبير، ويجب أن يكون الرمز المحلي بأحرف صغيرة:
${datetime | locale:"pt-br"}
ملاحظة:
للحصول على معلومات عن الرمز المحلي للغة محددة، راجع قائمة رموز ISO 639-1 التابعة لويكيبيديا. ومع ذلك، لا يدعم Survey123 كل هذه اللغات.
يتم تخزين جميع قيم التاريخ والوقت في طبقة المعالم بالتوقيت العالمي المنسق (UTC). بشكل افتراضي، تكون جميع قيم التاريخ والوقت التي يتم إرجاعها في التقرير في المنطقة الزمنية نفسها مثل مستعرض الويب الذي كان يُستخدم لطلب إنشاء التقرير. يمكنك استخدام طريقة utcOffset لتبديل عرض هذه القيم في تقرير ما لمطابقة منطقة زمنية محددة. يعرض التعبير التالي الرد على سؤال التاريخ والوقت الذي تمت إزاحته بمقدار ساعة واحدة من التوقيت العالمي المنسق:
${datetime | utcOffset:"+01:00"}
تدعم طريقة utcOffset تنسيقات +01:00، و+0100، و+01، وتُرجِع النتيجة نفسها. يمكنك أيضًا استخدام هذه الطريقة لتبديل عرض وقت إرسال الإجابة.
بالنسبة إلى أسئلة التاريخ والتاريخ-الوقت، يمكنك استخدام تعبير لتنسيق التاريخ باستخدام العناصر النائبة DD وMM وYYYY لليوم والشهر والسنة على التوالي. يظهر التعبير التالي اليوم والشهر فقط، مع حذف السنة:
${date | format:"DD/MM"}
يمكنك أيضًا تنسيق الوقت في أسئلة التاريخ-الوقت، باستخدام HH، وmm، وss كعناصر نائبة للساعات والدقائق والثواني على التوالي. يظهر التعبير التالي اليوم والشهر والساعات والدقائق:
${datetime | format:"DD/MM HH:mm"}
يمكنك عرض التواريخ والأوقات بتنسيق ISO 8601 لـ YYYY-MM-DDTHH:mm:ss±HH:mm من خلال ترك قيمة طريقة format فارغة، كما هو موضح في المثال التالي:
${datetime | format:""}
للحصول على مزيد من المعلومات عن تنسيقات التاريخ والوقت، راجع الجدول التالي.
ملاحظة:
يجب عليك وضع طريقة format في نهاية التعبير.
يمكنك طباعة تاريخ ووقت إنشاء التقرير باستخدام الكلمة الأساسية $date. استخدم طريقة format للتحكم في طباعة التاريخ أو الوقت أو كليهما. يطبع المثال التالي التاريخ الذي تم فيه إنشاء التقرير (بدون الوقت) بتنسيق التاريخ الافتراضي لموقعك المحلي:
${$date}
يطبع التعبير التالي الشهر واليوم والسنة والساعات والدقائق لتاريخ ووقت إنشاء التقرير:
${$date | format:"MM/DD/YYYY HH:mm"}
يطبع التعبير التالي الوقت الذي تم إنشاء التقرير فيه (بدون التاريخ) بالساعات والدقائق والثواني بنظام 12 ساعة:
${$date | format:"h:mm:ss A"}
تدعم الكلمة الرئيسية $date أيضًا طرق utcOffset وlocale. يتم تجاهل الطريقة locale عند تحديد كلٍ من format وlocale.
تنسيقات التاريخ والوقت
يوضح الجدول التالي أكثر العناصر النائبة شيوعًا التي يمكن استخدامها مع طريقة format لتنسيق التواريخ والأوقات في أسئلة التاريخ والتاريخ-الوقت ضمن التقارير:
عنصر نائب | الوصف |
---|---|
YY | آخر رقمين من السنة. مثال: سيتم تمثيل 2023 كـ 23. |
YYYY | الأربعة أرقام للسنة. مثال: سيتم تمثيل 2023 كـ 2023. |
M | رقم الشهر بين 1 و12. مثال: سيتم تمثيل يناير كـ 1. |
MM | رقم الشهر مكون من رقمين. مثال: سيتم تمثيل يناير كـ 01. |
MMM | شهر في ثلاثة أحرف. مثال: سيتم تمثيل يناير في صورة ينا. |
MMMM | اسم الشهر بالكامل مثال: سيتم تمثيل يناير في صورة يناير. |
D | رقم اليوم بين 1 و31. مثال: يتم تمثيل اليوم الأول من الشهر في صورة 1. |
DD | رقم اليوم مكون من رقمين. مثال: يتم تمثيل اليوم الأول من الشهر في صورة 01. |
افعل | رقم اليوم الذي يتضمن لاحقات ترتيبية. مثال: يتم تمثيل اليوم الأول من الشهر على أنه الأول. |
H | رقم الساعة بنظام 24 ساعة. مثال: 11 مساءً. سيتم تمثيله على أنه 23. |
HH | رقم الساعة بنظام 24 ساعة في رقمين. مثال: سيتم تمثيل الساعة 2 صباحًا على أنها 02. |
ساعة | رقم الساعة بتوقيت 12 ساعة. مثال: 11 مساءً. سيتم تمثيله على أنه 11. |
hh | رقم الساعة بتوقيت 12 ساعة في رقمين. مثال: سيتم تمثيل الساعة 2 صباحًا على أنها 02. |
m | رقم الدقيقة بين 0 و59. مثال: سيتم تمثيل 8 دقائق على أنها 8. |
مم | رقم الدقيقة في رقمين. مثال: 8 دقائق سيتم تمثيلها على أنها 08. |
ss | يتكون الرقم الثاني من عددين. مثال: سيتم تمثيل 9 ثوانٍ كـ 09. |
Z | إزاحة المنطقة الزمنية بالساعات باستخدام الفاصل. أمثلة: -07:00، +13:00 |
ZZ | إزاحة المنطقة الزمنية بالساعات بدون فاصل. أمثلة: -0700، +1300 |
x | طابع زمني لتوقيت UNIX بالمللي ثانية. مثال: سيتم تمثيل 9 مساءً في 4 مايو 2023 بتوقيت جرينتش كـ 1683234000000. |
X | طابع زمني لتوقيت UNIX. مثال: سيتم تمثيل 9 مساءً في 4 مايو 2023 بتوقيت جرينتش كـ 1683234000. |
آر | تدوين الصباح أو بعد الظهر بأحرف صغيرة. مثال: سيتم تمثيل صباحًا بصيغة ص ومساءً سوف تُمثل كـ م. |
A | تدوين الصباح أو بعد الظهر بأحرف كبيرة. مثال: سيتم تمثيل صباحًا كـ ص ومساءً سوف تُمثل كـ م. |