الدالة DateDiff

هام: تمت ترجمة هذه المقالة ترجمة آلية، راجع إقرار إخلاء المسؤولية. يرجى الاطلاع على النسخة الإنجليزية من هذه المقالة. هنا للرجوع إليها.

تقوم بإرجاع متغير (نوع بيانات طويل) يحدد عدد الفواصل الزمنية بين تاريخين محددين.

راجع بعض الامثله

بناء الجملة

DateDiff ( فاصل زمني، تاريخ 1، تاريخ 2 [، اول ايام الاسبوع] [، اول اسابيع السنه] )

يحتوي بناء جمله الداله DateDiff علي الوسيطات التاليه:

تلميح: في Access 2010، علي "منشئ التعبير" IntelliSense، حيث يمكنك رؤيه ما الوسيطات يتطلب التعبير.

الوسيطة

الوصف

الفاصل الزمني

مطلوب. تعبير سلسله يكون فاصلا زمنيا تستخدمه ل# حساب الفرق بين تاريخ 1وتاريخ 2.

التواريخ 1، تاريخ 2

مطلوب. متغير (تاريخ). تاريخين التي تريد استخدامها في العمليه الحسابيه.

اول ايام الاسبوع

اختياري. ثابت يحدد اليوم الاول من الاسبوع. اذا لم يكن محددا، من المفترض الاحد.

اول اسابيع السنه

اختياري. ثابت يحدد الاسبوع الاول من السنه. اذا لم يكن محددا، الاسبوع الاول من المفترض ان الاسبوع الذي 1 يناير.


الإعدادات

الفاصل الزمني ل# وسيطة يحتوي علي هذه الاعدادات:

الإعداد

الوصف

yyyy

السنة

q

ربع السنة

m

الشهر

y

يوم في السنه

d

اليوم

w

Weekday

حول العالم

الأسبوع

h

الساعة

د

الدقيقة

s

الثانية


اعلي الصفحه

الوسيطه اول ايام الاسبوع يحتوي علي هذه الاعدادات:

ثابت

القيمة

الوصف

فبوسيسيستيم

0

استخدم الاعداد NLS API.

vbSunday

1

يوم الاحد (افتراضي)

vbMonday

2

الاثنين

فبتويسداي

3

الثلاثاء

فبويدنيسداي

4

الأربعاء

فبثورسداي

5

الخميس

فبفريداي

6

الجمعة

فبساتورداي

7

السبت


ثابت

القيمة

الوصف

فبوسيسيستيم

0

استخدم الاعداد NLS API.

vbFirstJan1

1

ابدا ب# الاسبوع الذي 1 يناير (افتراضي).

فبفيرستفوردايس

2

ابدا ب# اول اسبوع الذي يحتوي علي اربعه ايام علي الاقل في السنه الجديده.

فبفيرستفولويك

3

ابدا ب# اول اسبوع كامل من السنه.


ملاحظات

يمكنك استخدام الداله DateDiff ل# تحديد عدد الفواصل الزمنيه المحدده الموجوده بين تاريخين. علي سبيل المثال، يمكنك استخدام DateDiff ل# حساب عدد الايام بين تاريخين، او عدد الاسابيع بين اليوم و# نهايه السنه.

ل# حساب عدد الايام بين تاريخ 1وتاريخ 2، يمكنك استخدام اما يوم في السنه ("y") او يوم ("d"). عندما يكون الفاصل الزمني ل# يوم من ايام الاسبوع ("w")، ترجع DateDiff عدد الاسابيع بين التاريخين. اذا وقع تاريخ 1 في يوم الاثنين، DateDiff حساب عدد ايام الاثنين حتي تاريخ 2. يتم حساب تاريخ 2 و# لكن ليس التواريخ 1. اذا كان الفاصل الزمني ل# الاسبوع ("حول العالم")، و# مع ذلك، ترجع الداله DateDiff عدد اسابيع التقويم بين التاريخين. يتم حساب ايام الاحد بين تاريخ 1وتاريخ 2. تحسب DateDiffتاريخ 2 عند وقوعها يوم الاحد؛ و# لكن لا حساب التواريخ 1، حتي لو تقع علي الاحد.

اذا اشارت التواريخ 1 الي نقطه في الوقت من تاريخ 2، ترجع الداله DateDiff عدد سالب.

يؤثر الوسيطه اول ايام الاسبوع العمليات الحسابيه التي تستخدم الرموز الفاصل الزمني "w" و "حول العالم".

اذا كانت التواريخ 1 او تاريخ 2أحرف التاريخ، تصبح السنه المحدده جزءا دائما من هذا التاريخ. و# مع ذلك، اذا كانت التواريخ 1 او تاريخ 2 بين علامتي اقتباس مزدوجه ("")، و# قمت ب# حذف السنه، يتم ادراج السنه الحاليه في التعليمات البرمجيه في كل مره يتم تقييم التعبير التواريخ 1 او تاريخ 2 . يؤدي ذلك الي المحتمله كتابه التعليمات البرمجيه التي يمكن استخدامها في سنوات مختلفه.

عند مقارنه 31 ديسمبر الي 1 يناير من السنه التاليه، ترجع DateDiff ل# السنه ("yyyy") 1، علي الرغم من ان مرور يوم واحد فقط.

ملاحظة: ل# تاريخ 1وتاريخ 2، اذا كان اعداد الخاصيه التقويم الميلادي، يجب ان يكون التاريخ الميلادي. اذا كان التقويم الهجري، يجب ان يكون التاريخ التقويم الهجري.

اعلي الصفحه

أمثلة

استخدم الداله DateDiff في تعبير     يمكنك استخدام الداله DateDiff اينما يمكنك استخدام التعبيرات. علي سبيل المثال، افترض ان لديك نموذج التي تستخدمها ل# تنفيذ اوامر العميل. في جدول الطلبات، لديك حقل يسمي ريسيفيبيفوري التي تحتوي علي تاريخ الذي يحتاج العميل ل# تلقي الترتيب. يمكنك استخدام الداله DateDiff مع مربع نص علي النموذج ل# عرض عدد الايام المتبقيه قبل يجب شحن الترتيب.

مع افتراض ان تتطلب عشره ايام شحن اي ترتيب، قم ب# تعيين خاصيه مصدر عنصر التحكم ل# مربع النص كما يلي:

= DateDiff("d", Now(), [Orders].[ ريسيفيبيفوري])-10

عند فتح النموذج في طريقه عرض النموذج، يعرض مربع النص عدد الايام المتبقيه قبل يجب شحن الترتيب. اذا كان هناك اقل من 10 ايام اليسار قبل العميل ب# حاجه الي تلقي الترتيب، الرقم في مربع النص عباره عن قيمه سالبه و# يشير الي عدد الايام المتاخر سوف يظهر الترتيب اذا شحنها مباشره.

استخدم الداله DateDiff في التعليمات البرمجيه ل VBA   

ملاحظة: توضح الامثله التاليه استخدام هذه الداله في Visual Basic for Applications (VBA) الوحده النمطيه. ل# الحصول علي مزيد من المعلومات حول العمل ب# استخدام VBA، حدد مرجع المطور في القائمه المنسدله الموجود ب# جانب بحث و# ادخل شروط واحد او اكثر في مربع البحث.

يستخدم هذا المثال الداله DateDiff ل# عرض عدد الايام بين تاريخ معين و# اليوم.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg

ملاحظة: إقرار إخلاء المسؤولية للترجمة الآلية: تمت ترجمة هذه المقالة بواسطة نظام كمبيوتر دون تدخل العامل البشري. توفر Microsoft هذه الترجمات الآلية لمساعدة المستخدمين الذين لا يتحدثون الإنجليزية على استخدام منتجات Microsoft، وخدماتها، وتقنياتها والاستمتاع بها. قد تحتوي هذه المقالة على أخطاء في المفردات، أو بناء الجملة، أو القواعد نظرًا لترجمتها آليًا.

توسيع المهارات
استكشاف التدريب
الحصول على الميزات الجديدة أولاً
الانضمام إلى Office Insider

هل كانت المعلومات مفيدة؟

نشكرك على ملاحظاتك!

شكراً لك على الملاحظات! يبدو أنه من المفيد إيصالك بأحد وكلاء دعم Office لدينا.

×