الدالة DateSerial

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

تقوم بإرجاع متغير (تاريخ) لسنة معيّنة أو شهر معيّن أو يوم معيّن.

بناء الجملة

DateSerial ( سنة، شهر، يوم )

يحتوي بناء جملة الدالة 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)

يتم تفسير السنوات المكونة من رقمين للوسيطة year طبقاً لإعدادات الجهاز المحددة من قبل المستخدم. ويتم تفسير الإعدادات الافتراضية للقيم بين صفر و29، متضمنة هذين الرقمين كسنوات ما بين 2000–2029. ويتم تفسير القيم الافتراضية بين 30 و99 كسنوات ما بين 1930–1999. أما بالنسبة لكافة وسيطات year الأخرى، استخدم السنوات المكونة من أربعة أرقام (على سبيل المثال، 1800).

أما إصدارات Windows الأقدم من Windows 2000، فيتم تفسير السنوات المكونة من أربعة أرقام طبقًا للافتراضات الموضحة أعلاه. وللتأكد من إرجاع القيمة الصحيحة، استخدم السنة المكونة من أربعة أرقام.

عندما تتجاوز أي وسيطة النطاق المقبول لتلك الوسيطة، يتم إضافتها إلى الوحدة التالية الأكبر المناسبة. على سبيل المثال، إذا قمت بتحديد 35 يوماً، يتم تقييمها كشهر واحد وبعض الأيام، وذلك طبقاً لجزء السنة الذي يتم التطبيق عليه. في حالة وجود أي وسيطة فردية خارج النطاق -32,768 إلى 32,767، يحدث خطأ. أما إذا كان التاريخ المحدد بواسطة الثلاث وسائط يقع خارج نطاق التواريخ المقبول، يحدث خطأ.

ملاحظة: بالنسبة لـ year وmonth وday، إذا كان إعداد الخاصية التقويم "ميلاديًا"، فمن المفترض أن تكون القيمة ميلادية. وإذا كان إعداد الخاصية التقويم هجريًا، فمن المفترض أن تكون القيمة هجرية.

يكون جزء التاريخ الذي يتم إرجاعه في الوحدات الزمنية لتقويم Visual Basic الحالي. على سبيل المثال، إذا كان التقويم الحالي هجرياً وجزء التاريخ الذي سيتم إرجاعه هو السنة، تكون قيمة السنة عبارة عن سنة هجرية. بالنسبة للوسيطة year، يتم تعريف القيم بين صفر و99 بما فيها هذين الرقمين كالسنوات 1400-1499. بالنسبة لقيم year الأخرى، استخدم السنة المكونة من أربعة أرقام (على سبيل المثال، 1520).

مثال

ملاحظة: توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية لـ 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.

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

مشاركة Facebook Facebook Twitter Twitter البريد الإلكتروني البريد الإلكتروني

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

رائع! هل لديك أي ملاحظات أخرى؟

كيف يمكننا تحسين ذلك؟

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

×