تقوم بإرجاع متغير (تاريخ) لسنة معيّنة أو شهر معيّن أو يوم معيّن.
بناء الجملة
DateSerial ( year, month, day )
Warning تأكد من أن الوسيطات في النطاق الصحيح من القيم. يمكن أن تؤدي الوسيطة غير الصالحة إلى نتيجة غير صحيحة.
يحتوي بناء جملة الدالة DateSerial على هذه الوسيطات:
|
الوسيطة |
الوصف |
|
عام |
مطلوبة. عدد صحيح. العدد بين 100 و9999، ضمنا، أو تعبير رقمي. |
|
شهر |
مطلوبة. عدد صحيح. أي تعبير رقمي. |
|
يوم |
مطلوبة. عدد صحيح. أي تعبير رقمي. |
ملاحظات
لتحديد تاريخ، مثل 31 ديسمبر 1991، يجب أن يكون نطاق الأرقام لكلوسيطةDateSerial في النطاق المقبول للوحدة؛ أي 1-31 للأيام و1-12 للأشهر. ومع ذلك، يمكنك أيضا تحديد تواريخ نسبية لكل وسيطة باستخدام أي تعبير رقمي يمثل بعض الأيام أو الأشهر أو السنوات قبل تاريخ معين أو بعده.
يستخدم المثال التالي تعبيرات رقمية بدلا من أرقام التواريخ المطلقة. هنا ترجع الدالة DateSerial تاريخا يسبق اليوم الأول (1 - 1)، قبل شهرين من أغسطس (8 - 2)، قبل 10 سنوات من عام 1990 (1990 - 10)؛ وبعبارة أخرى، 31 مايو 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
يتم تفسير السنوات المكونة من رقمين لوسيطة السنة استنادا إلى إعدادات الجهاز المعرفة من قبل المستخدم. الإعدادات الافتراضية هي أن القيم بين 0 و29، شاملة، يتم تفسيرها على أنها السنوات 2000-2029. يتم تفسير القيم الافتراضية بين 30 و99 على أنها السنوات 1930-1999. بالنسبة لجميع وسيطات السنة الأخرى، استخدم سنة مكونة من أربعة أرقام (على سبيل المثال، 1800).
تفسر إصدارات Windows الأقدم من Windows 2000 السنوات المكونة من رقمين استنادا إلى الإعدادات الافتراضية الموضحة أعلاه. للتأكد من أن الدالة ترجع القيمة المناسبة، استخدم سنة مكونة من أربعة أرقام.
عندما تتجاوز أي وسيطة النطاق المقبول لتلك الوسيطة، فإنها تزيد إلى الوحدة الأكبر التالية حسب الاقتضاء. على سبيل المثال، إذا حددت 35 يوما، يتم تقييمها كشهر واحد وعدد من الأيام، اعتمادا على مكان تطبيقها في السنة. إذا كانت أي وسيطة واحدة خارج النطاق -32768 إلى 32767، يحدث خطأ. إذا كان التاريخ المحدد بواسطة الوسيطات الثلاث يقع خارج نطاق التواريخ المقبول، يحدث خطأ.
ملاحظة: بالنسبة للسنةوالشهرواليوم، إذا كان إعداد خاصية التقويم ميلاديا، فسيتم افتراض أن القيمة المقدمة ميلادية. إذا كان إعداد خاصية التقويم هو الهجري، فسيتم افتراض أن القيمة المقدمة هي الهجرية.
جزء التاريخ الذي تم إرجاعه موجود في وحدات الفترة الزمنية للتقويم Visual Basic الحالي. على سبيل المثال، إذا كان التقويم الحالي هو الهجري وجزء التاريخ الذي سيتم إرجاعه هو السنة، فإن قيمة السنة هي سنة هجرية. بالنسبة لسنة الوسيطة، يتم تفسير القيم بين 0 و99، شاملة، على أنها السنوات 1400-1499. بالنسبة لجميع قيم السنة الأخرى، استخدم السنة الكاملة المكونة من أربعة أرقام (على سبيل المثال، 1520).
مثال على الاستعلام
|
تعبير |
النتائج |
|
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
إرجاع "التاريخ" للسنة والشهر واليوم المحددين الذي تم إدخاله في وسيطات الدالة ويعرض في العمود "NewDate". النتيجة: "13/12/2018". |
مثال VBA
ملاحظة: توضح الأمثلة التالية استخدام هذه الدالة في وحدة Visual Basic for Applications (VBA). لمزيد من المعلومات حول العمل مع VBA، حدد مرجع المطور في القائمة المنسدلة بجوار البحث وأدخل مصطلحا واحدا أو أكثر في مربع البحث.
يستخدم هذا المثال الدالة DateSerial لإرجاع التاريخ للسنة والشهر واليوم المحددين.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.
