لقد تم شرح DatePart في الدليل المرجعي لـ ASP (VBScript)، لكن شرحه للمعلمة الأولى مكتوب ومضلل للغاية، فلنشرحه مرة أخرى.
بناء جملة DatePart هو DatePart(interval, date)، والذي يُستخدم للحصول على جزء معين من التاريخ.
فاصلة
yyyy: سنة في التاريخ
م: شهر في التاريخ
د: يوم في التاريخ
ح: ساعة في التاريخ
ن: دقيقة في التاريخ
الصورة: ثانية في التاريخ
س: في أي ربع من السنة يقع التاريخ، على سبيل المثال، 2009-6-29 يقع في الربع الثاني.
y: التاريخ يقع في يوم من أيام السنة، على سبيل المثال، 29-6-2009 يقع في اليوم 180.
w: التاريخ يقع في يوم من أيام الأسبوع (الأحد هو اليوم الأول افتراضيًا)، على سبيل المثال، 29-6-2009 يقع في اليوم الثاني.
ww: التاريخ يقع في الأسبوع من العام، على سبيل المثال، 29-6-2009 يقع في الأسبوع السابع والعشرين.
DatePart(الفاصل الزمني، التاريخ[، اليوم الأول من الأسبوع[، الأسبوع الأول من العام]])
يحتوي بناء جملة الدالة DatePart على المعلمات التالية:
وصف المعلمة
الفاصل الزمني مطلوب. تعبير سلسلة يمثل الفاصل الزمني للعودة. راجع قسم الإعدادات لمعرفة القيم.
التاريخ مطلوب. تعبير التاريخ المطلوب تقييمه.
اليوم الأول من الأسبوع اختياري. ثابت يحدد اليوم الأول من الأسبوع. إذا لم يتم تحديده، فسيتم تعيينه افتراضيًا إلى يوم الأحد. راجع قسم الإعدادات لمعرفة القيم.
الأسبوع الأول من العام اختياري. الثابت الذي يحدد الأسبوع الأول من السنة. إذا لم يتم تحديده، فسيتم تعيينه افتراضيًا إلى الأسبوع الذي يبدأ في الأول من يناير. راجع قسم الإعدادات لمعرفة القيم.
يمكن ضبط معلمة الفاصل الزمني على القيم التالية:
وصف الإعداد
سنة
ف الربع
م الشهر
y عدد أيام السنة
د يوم
ث يوم من أيام الأسبوع
أسابيع رطب
ساعات ح
م دقيقة
ثواني
يمكن أن تحتوي المعلمة firstdayofweek على القيم التالية:
وصف القيمة الثابتة
vbUseSystem 0 استخدم إعداد API لدعم اللغة الوطنية (NLS).
vbSunday 1 الأحد (افتراضي)
vbMonday 2 الاثنين
vbالثلاثاء 3 الثلاثاء
vbالأربعاء 4 الأربعاء
vbالخميس 5 الخميس
vbالجمعة 6 الجمعة
vbالسبت 7 السبت
يمكن أن تحتوي المعلمة firstweekofyear على القيم التالية:
وصف القيمة الثابتة
vbUseSystem 0 استخدم إعداد API لدعم اللغة الوطنية (NLS).
vbFirstJan1 1 يبدأ بالأسبوع الذي يبدأ في الأول من يناير (افتراضي).
يبدأ vbFirstFourDays 2 بالأسبوع الأول من العام الجديد الذي يتكون من أربعة أيام على الأقل.
يبدأ vbFirstFullWeek 3 بالأسبوع الكامل الأول من العام الجديد (وليس عبر السنوات).
يوضح
تقوم الدالة DatePart بحساب تاريخ وإرجاع فاصل زمني محدد. على سبيل المثال، استخدم DatePart لحساب يوم الأسبوع أو الوقت الحالي في يوم معين.
تؤثر المعلمة firstdayofweek على العمليات الحسابية التي تستخدم رموز الفاصل الزمني "w" و"ww".
إذا كان التاريخ عبارة عن تاريخ حرفي، تصبح السنة المحددة جزءًا ثابتًا من التاريخ. ولكن إذا كان التاريخ محاطًا بعلامات اقتباس (" ") وتم حذف السنة، فسيتم إدراج السنة الحالية في كل مرة يتم فيها تقييم تعبير التاريخ في التعليمات البرمجية. وهذا يجعل من الممكن كتابة كود البرنامج الذي يعمل لسنوات مختلفة.