معلومات التواريخ (إصدار رقم 20.11.1.0+ من نظام معلومات الطلاب في PowerSchool)
يستخرج معلم الوصول إلى البيانات الخاص بمعلومات التواريخ معلومات مختلفة للتواريخ ويسمح باستخدام التنسيق المتقدم.
التنسيق: ~(date.information;type=[type];schoolid=[schoolid];yearid=[yearid];termabbr=[termabbr];offset=[offset];dateformat=[dateformat])
|
المعلّمة |
الاستخدام والأمثلة |
الوصف |
|---|---|---|
|
النوع |
~(date.information;type=اليوم ~(date.information;type=current_term_start ~(date.information;type=current_term_end ~(date.information;type=current_year_start ~(date.information;type=current_year_end ~(date.information;type=term_start ~(date.information;type=term_end |
يحدد نوع معلومات التواريخ المُراد استرجاعها. باستثناء معلومات التواريخلليوم، وذلك لأن استرجاع التواريخ من جدول الفصول الدراسية يعتمد على القيم الموجودة في ذاكرة التخزين المؤقت. |
|
معرف المدرسة (SchoolId) |
~(date.information;schoolid=100 |
اختياري -مضبوط على الإعدادات الافتراضية للمدرسة المحددة حاليًّا. الفصول الدراسية الخاصة بمعرف المدرسة (المدارس.School_Number) المُراد تقييمها. (The Terms.SchoolID (Schools.) to evaluate.) |
|
معرف العام (YearId) |
~(date.information;yearid=29 |
اختياري -مضبوط على الإعدادات الافتراضية للعام المحدد حاليًّا. (Optional - Defaults to the currently selected year.) معرفات الفصول الدراسية حيث يوجد معرف العام* 100 المُراد تقييمه. (The Terms.ID where YearID * 100 to evaluate) |
|
اختصار الفصل الدراسي (Termabbr) |
~(date.information;termabbr=S1 |
يُطلب عندما يكون النوعterm_startأوterm_end. يحدد سجلات الفصول الدراسية الُمُراد تقييمها بناءً على اختصارات الفصول الدراسية. |
|
مدة التأخر (Offset) |
~(date.information;offset=1 |
يحدد مدة التأخر المراد تطبيقها على التاريخ الذي تم استرجاعه. يمكن إدخال رقم موجب أو سالب. على سبيل المثال: غدا: ~(date.information;type=today;offset=1) الأمس: ~(date.information;type=today;offset=-1) |
|
تنسيق التاريخ |
~(date.information;dateformat=MM-dd-yyyy |
يحدد تنسيق التاريخ للحصول على نتيجة. إن هذا التنسيق حساس لحالة الأحرف ويعتمد على رموز لغة برمجة Java لمنسق التاريخ والوقت (DateTimeFormatter).
مضبوط على الإعدادات الافتراضية لتنسيق التاريخ المحلي للمستخدمين الحاليين. |
مثال رقم 1:
~(date.information;type=current_term_start;dateformat=MM-dd-yyyy)
يُرجع هذا المثال تاريخ بدء المصطلحات الحالية بتنسيق الشهر-اليوم-العام. يسترجع هذا المثال تاريخ بدء الفصول الدراسية الحالية بتنسيق الشهر-اليوم-العام.
مثال رقم 2:
~(date.information;type=term_end;termabbr=S1;dateformat=MM-dd-yyyy)
يسترجع هذا المثال آخر يوم في سجلات الفصول الدراسية للمدارس الحالية والأعوام التي تحمل الاختصار S1 بتنسيق الشهر-اليوم-العام.
المثال الثالث:
~(date.information;type=term_end;termabbr=S1;yearid=29;dateformat=MM-dd-yyyy)
يسترجع هذا المثال آخر يوم في سجلات الفصول الدراسية للمدارس الحالية والعام الدراسي 2019-2020، حيث يوجد الفصل الدراسي باختصار S1 بتنسيق الشهر-اليوم-العام.