دوال التاريخ

[أبو امين]

الدالة DateAdd

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

بناء الجملة

DateAdd ( فاصل زمني، رقم، تاريخ)

بناء جملة الدالة DateAdd على هذه الوسيطات:

الوسيط	الوصف
فاصل	مطلوبة. تعبير السلسلة هو الفاصل الزمني للوقت الذي تريد إضافته.
number	مطلوبة. تعبير رقمي هو عدد الفواصل الزمنية التي تريد إضافتها. يمكن أن تكون إيجابية (للحصول على التواريخ في المستقبل) أو سالبة (للحصول على التواريخ في الماضي).
تاريخ	مطلوبة. متغير (تاريخ) أو حرف يمثل التاريخ الذي يتم إضافة الفاصل الزمني له.

الإعدادات

الفاصل وسيطة الإعدادات التالية:

الإعداد	الوصف
yyyy	السنة
q	ربع السنة
m	الشهر
y	يوم في السنة
d	يوم
w	Weekday
ww	الأسبوع
h	الساعة
د	الدقيقة
s	الثانية

ملاحظات

يمكنك استخدام الدالة DateAdd لإضافة فاصل زمني معين أو طرحه من تاريخ. على سبيل المثال، يمكنك استخدام DateAdd لحساب تاريخ بعد 30 يوما من اليوم أو 45 دقيقة من الآن.

لإضافة أيام إلى تاريخ،يمكنك استخدام يوم من السنة ("y") أو يوم ("d") أو يوم من أيام الأسبوع ("w").

لن ترجع الدالة DateAdd تاريخا غير صالح. يضيف المثال التالي شهرا واحدا إلى 31 يناير:

DateAdd("m", 1, "31-Jan-95")

في هذه الحالة، ترجع DateAdd 28 - فبراير - 95، وليس 31 - فبراير - 95. إذا كان التاريخ هو 31 يناير- 96، فإنه يرجع 29 - فبراير - 96 لأن 1996 سنة كبيسة.

إذا كان التاريخ المحسوب يسبق السنة 100 (أي أنك تطرح سنوات أكثر مما هي عليه في التاريخ)، فيحدث خطأ.

إذا لم تكن قيمة الرقم قيمة طويلة، فيقرب الرقم إلى أقرب عدد صحيح قبل تقييمه.

ملاحظة:  يتم تحديد تنسيق القيمة المرجعة ل DateAdd من خلال إعدادات لوحة التحكم، وليس حسب التنسيق الذي يتم تمريره في وسيطة التاريخ.

ملاحظة:  بالنسبة إلى التاريخ،إذا كان إعداد خاصية التقويم ميلاديا، فيجب أن يكون التاريخ الذي تم توفيره ميلاديا. إذا كان التقويم هو الهجري، فيجب أن يكون التاريخ الذي تم توفيره هو الهجري. إذا كانت قيم الشهر أسماء، فيجب أن يكون الاسم متناسقا مع إعداد خاصية التقويم الحالية. لتقليل إمكانية تعارض أسماء الشهر مع إعداد خاصية التقويم الحالي، أدخل قيم الشهر رقمي (تنسيق التاريخ القصير).

أمثلة على الاستعلام

التعبير	النتائج
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales;	ترجع النتائج بإضافة سنة واحدة إلى قيم تاريخ الحقل "DateofSale".
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales;	ترجع النتائج عن طريق طرح سنة واحدة لقيم تاريخ الحقل "DateofSale".
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales;	ترجع النتائج في العمود "NewDate" بإضافة 10 أيام إلى قيم تاريخ الحقل "DateofSale".
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales;	ترجع النتائج في العمود "NewDate" عن طريق طرح أسبوع واحد (7 أيام) من قيم تاريخ الحقل "DateofSale".

مثال VBA

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

يأخذ هذا المثال تاريخا كمدخل ويستخدم الدالة DateAdd لعرض تاريخ مقابل لعدد محدد من الأشهر في المستقبل.

Dim FirstDate As Date ' Declare variables. Dim IntervalType As String Dim Number As Integer Dim Msg IntervalType = "m" ' "m" specifies months as interval. FirstDate = InputBox("Enter a date") Number = InputBox("Enter number of months to add") Msg = "New date: " & _ DateAdd(IntervalType, Number, FirstDate) MsgBox Msg