وظيفة datediff
إرجاع قيمة المتغير (طويل) مما يشير إلى عدد الفواصل الزمنية بين فترتين نهاريتين محددتين.
بناء جملة Datediff (الفاصل الزمني ، Date1 ، Date2 [، FirstdayOfweek [، Firstweekofyear]])
يتم تضمين المعلمات التالية المسماة في بناء جملة دالة Datediff:
الوصف الجزئي الفاصل الزمني ضروري. تعبير السلسلة ، الذي يمثل الفاصل الزمني المستخدم لحساب الفرق الزمني بين التاريخ 1 و Date2
Date1 □ Date2 مطلوب ؛ متغير (تاريخ). التواريخ لاستخدامها في الحساب.
FirstdayOfweek اختياري. يحدد الثابت لليوم الأول من الأسبوع. إذا لم يتم تحديدها ، فإن الأحد هو اليوم الأول.
firstweekofyear اختياري. يحدد الثابت للأسبوع الأول من العام. إذا لم يتم تحديده ، فإن الأسبوع الذي يحتوي على 1 يناير هو الأسبوع الأول.
إعداد قيمة الإعداد للمعلمة الفاصلة كما يلي: (وصف الإعداد)
سنة Yyyy
س موسم
شهر
y عدد الأيام في سنة واحدة
D يوم
ث عدد أيام الأسبوع
WW
ح
ن دقائق
ثانية
القيمة المحددة لمعلمة DayOfweek هي كما يلي: (وصف القيمة الثابتة)
VBUSESYSTEM 0 استخدم إعدادات API NLS.
vbsunday 1 الأحد (افتراضي)
vbmonday 2 الاثنين
vbtuesday 3 الثلاثاء
vbwednesday 4 الأربعاء
vbthursday 5 الخميس
vbfriday 6 الجمعة
vbsaturday 7 السبت
وصف قيمة ثابتة
تم إعداد VBUSESYSTEM 0 مع API NLS.
يبدأ VBFirstjan1 1 من الأسبوع الذي يحتوي على 1 يناير (افتراضي).
يبدأ VBFirstFourDays 2 بأول أسبوع من الأسبوعين في أسبوع العام الجديد.
يبدأ VBFirstfullWeek 3 بالأسبوع الأول بدون العام.
يوضح:
يمكن استخدام وظيفة Datediff لتحديد عدد الفواصل الزمنية المحددة بين تواريخين. على سبيل المثال ، يمكنك استخدام Datediff لحساب عدد الأيام التي يتم فيها توجيهات بين تاريخين ، أو عدد الأسابيع التي ستكون بينها اليوم ونهاية العام. لحساب عدد الأيام التي يكون فيها Date1 و Date2 ، يمكنك استخدام عدد الأيام (Y) أو اليوم (د) من سنة واحدة. عندما يكون الفاصل الزمني هو عدد أيام الأسبوع (W) ، يعيد Datediff عدد الأسابيع خلال فترة يومين. إذا كان Date1 يوم الاثنين ، فإن Datediff يحسب عدد الاثنين حتى Date2. يحتوي هذا الرقم على Date2 ولكن ليس Date1. ومع ذلك ، إذا كان الفاصل الزمني هو الأسبوع (WW) ، فإن وظيفة Datediff تعيد أسابيع التقويم لمدة يومين. يتم الحصول عليها عن طريق حساب عدد الأحد بين Date1 و Date2. إذا كان Date2 هو يوم الأحد ، فسيتم إضافة Date2 أيضًا إلى نتيجة عدد Datediff ؛ ولكن بغض النظر عما إذا كان Date1 يوم الأحد أم لا ، فلن يتم حسابه. إذا جاء Date1 متأخراً عن Date2 ، فإن قيمة الإرجاع لوظيفة Datediff سلبية. تؤثر المعلمة FirstDayOfweek على نتيجة الحسابات باستخدام رمز الفاصل الزمني W أو WW. إذا كان Date1 أو Date2 هو نص تاريخ ، فإن السنة المحددة تصبح جزءًا ثابتًا من هذا التاريخ. ومع ذلك ، إذا تم إرفاق Date1 أو Date2 في عروض أسعار مزدوجة ("") ويتم تخطي العام ، يتم إدراج السنة الحالية في الكود في كل مرة يتم فيها حساب Date1 أو Date2. يتيح لك ذلك كتابة رمز البرنامج المناسب لسنوات مختلفة. عند حساب الفرق في العام بين 31 ديسمبر و 1 يناير من العام التالي ، يعود Datediff 1 للإشارة إلى فرق عام ، على الرغم من أنه في الواقع يوم واحد فقط.