يصف
إرجاع الفاصل الزمني بين تاريخين.
قواعد
Datediff (الفاصل الزمني ، Date1 ، Date2 [، Firstdayofweek [، Firstweekofyear]])
تحتوي القواعد النحوية لوظيفة Datediff على المعلمات التالية:
وصف المعلمة
يجب اختيار الفاصل الزمني. يشير تعبير السلسلة إلى الفاصل الزمني بين Date1 و Date2. للاطلاع على القيم ، راجع جزء الإعداد.
Date1 ، يجب تحديد Date2. تعبير التاريخ. تاريخان للحساب.
Firstdayofwek اختياري. الثابت في اليوم الأول في الأسبوع المحدد. إذا لم يتم تحديد ذلك ، فإن الافتراضي هو الأحد. للاطلاع على القيم ، راجع جزء الإعداد.
firstweekofyear اختياري. حدد ثابت الأسبوع الأول من العام. إذا لم يتم تحديد ذلك ، فهو افتراضي إلى أسبوع 1 يناير. للاطلاع على القيم ، راجع جزء الإعداد.
يثبت
يمكن أن يكون للمعلمة الفاصلة القيم التالية:
تعيين الوصف
سنة Yyyy
س الربع
شهر ن
ص سنة واحدة
D يوم
ث لمدة أسبوع
أسبوع WW
H ساعة
دقائق م
ثانية
يمكن أن يكون للمعلمة FirstDayOfweek القيمة التالية:
وصف قيمة محدد
يستخدم VBUSESYSTER 0 إعدادات API لدعم اللغة الإقليمية (NLS).
vbsunday 1 الأحد (افتراضي)
vbmonday 2 الاثنين
vbtuesday 3 الثلاثاء
vbwednesday 4 الأربعاء
vbthursday 5 الخميس
vbfriday 6 الجمعة
vbsaturday 7 السبت
يمكن أن يكون للمعلمة First WeekoFyear القيمة التالية:
وصف قيمة محدد
يستخدم VBUSESYSTER 0 إعدادات API لدعم اللغة الإقليمية (NLS).
يبدأ VBFirstjan1 1 من أسبوع 1 يناير (الافتراضي).
يبدأ VBFirstFourDays 2 من الأسبوع الأول من أربعة أيام على الأقل في العام الجديد.
يبدأ VBFirstfullwek 3 مع أول أسبوع كامل في العام الجديد.
يوضح
يتم استخدام وظيفة Datediff لتحديد عدد الفاصل الزمني المحدد بين تاريخين. على سبيل المثال ، يمكن استخدام Datediff لحساب عدد الفرق بين الأيام بين تاريخين ، أو الرقم الأسبوعي بين اليوم واليوم الأخير من العام.
لحساب عدد الأيام بين Date1 و Date2 ، يمكنك استخدام عدد الأيام (Y) أو اليوم (د) من سنة واحدة. عندما يكون الفاصل الزمني هو عدد الأيام (W) من الأسبوع (W) ، يعيد Datediff الرقم الأسبوعي بين تاريخين. إذا كان Date1 يوم الاثنين ، يتم حساب عدد Datediff حتى تاريخ 2 قبل عدد الاثنين. تحتوي هذه النتيجة على Date2 بدون Date1. إذا كان الفاصل الزمني هو الأسبوع (WW) ، فإن وظيفة Datediff تعيد الرقم الأسبوعي بين تاريخين في جدول التقويم. يتم حساب عدد الوظائف بين Date1 و Date2. إذا كان Date2 يوم الأحد ، فسيقوم Datediff بحساب Date2 ، ولكن حتى إذا كان Date1 يوم الأحد ، فلن يتم حساب Date1.
إذا كان Date1 متأخراً عن Date2 ، فإن دالة Datediff تُرجع الأرقام السلبية.
تؤثر المعلمة FirstDayOfweek على حساب رمز الفاصل الزمني WW.
إذا كان Date1 أو Date2 هو نص تاريخ ، فستصبح السنة المحددة جزءًا ثابتًا من التاريخ. ومع ذلك ، إذا تم تضمين Date1 أو Date2 في علامات الاقتباس () وتم حذفه في السنة ، في كل مرة يتم حساب التعبير Date1 أو Date2 في الكود ، سيتم إدراجه في السنة الحالية. وبهذه الطريقة ، يمكنك كتابة رمز البرنامج المناسب لسنوات مختلفة.
عندما يكون الفاصل الزمني هو العام (Yyyy) ، مقارنة مع الأول من كانون الثاني (يناير) في 31 ديسمبر والعام المقبل ، على الرغم من وجود يوم واحد فقط ، يعود Datediff 1 للإشارة إلى فرق عام.
يستخدم المثال أدناه وظيفة Datediff لإظهار عدد الأيام بين اليوم والتاريخ المحدد:
وظيفة diffadatate (thedate)
diffadate = عدد الأيام التي تبدأ من نفس اليوم: & datingiff (D ، الآن ، thedate)
وظيفة نهاية