إرجاع متغير (عدد صحيح) يحتوي على رقم صحيح يمثل السنة.
بناء الجملة
Year(date)
إن وسيطة التاريخالمطلوب هي أي متغير أو تعبير رقمي أو تعبير سلسلة أو أية تركيبة من هذه العناصر يمكن أن تمثل تاريخا. إذا كان التاريخ يحتوي على Null، فيتم إرجاع القيمة Null .
ملاحظة
إذا كان إعداد خاصية Calendar ميلاديا، فإن العدد الصحيح الذي يتم إرجاعه يمثل السنة الميلادية لوسيطة التاريخ. إذا كان التقويم هجريا، فإن العدد الصحيح الذي يتم إرجاعه يمثل السنة الهجرية لوسيطة التاريخ. بالنسبة للتواريخ الهجرية، يكون رقم الوسيطة أي تعبير رقمي يمكن أن يمثل تاريخا و/أو وقتا من 1/1/100 (ميلادي أغسطس 2، 718) حتى 4/3/9666 (الميلادي ديسمبر 31، 9999).
أمثلة عن الاستعلام
| التعبير | النتائج |
|---|---|
| SELECT DateofSale, Year([DateofSale]) AS Expr1 FROM ProductSales; | ترجع هذه الدالة القيم من الحقل "تاريخ البيع" والرقم الذي يمثل "السنة" لقيم التاريخ هذه. |
| تحديد Year(#10/10/2018#) AS YearTest FROM ProductSales; | إرجاع الرقم الذي يمثل "السنة" من السلسلة "10/10/2018". النتيجة: 2018. |
مثال VBA
ملاحظة
توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية ل Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد "مرجع المطور" في القائمة المنسدلة بجوار "بحث" وأدخل مصطلح أو أكثر في مربع البحث.
يستخدم هذا المثال الدالة Year للحصول على السنة من تاريخ محدد. في بيئة التطوير، يتم عرض الحروف الحرفية للتاريخ بتنسيق تاريخ قصير باستخدام الإعدادات المحلية للتعليمة البرمجية الخاصة بك.
Dim MyDate, MyYear
MyDate = #February 12, 1969# ' Assign a date.
MyYear = Year(MyDate) ' MyYear contains 1969.