إرجاع متغير (عدد صحيح) يحتوي على رقم صحيح يمثل يوماً من الأسبوع.
بناء الجملة
Weekday(date [, firstdayofweek ] )
يحتوي بناء جملة الدالة Weekday على الوسيطات التالية:
| الوسيطة | الوصف |
|---|---|
| التاريخ | مطلوبة. متغير أو تعبير رقمي أو تعبير سلسلة أو أية تركيبة منها يمكن أن تمثل تاريخا. إذا كان التاريخ يحتوي على Null، فيتم إرجاع القيمة Null . |
| أول أيام الأسبوع | اختيارية. ثابت يحدد اليوم الأول من الأسبوع. إذا لم يتم تحديده ، فمن المفترض أن يكون vbSunday . |
إعدادات
تحتوي وسيطة أول أيام الأسبوع على هذه الإعدادات:
| القيمة الثابتة | Value | الوصف |
|---|---|---|
| vbUseSystem | 0 | استخدم إعداد NLS API. |
| vbSunday | 1 | الأحد (افتراضي) |
| vbMonday | 2 | الاثنين |
| vbالثلاثاء | 3 | الثلاثاء |
| vbWednesday | 4 | الأربعاء |
| vbالخميس | 5 | الخميس |
| vbFriday | 6 | الجمعة |
| vbالسبت | 7 | السبت |
إرجاع القيم
يمكن أن تقوم الدالة Weekday بإرجاع أي من القيم التالية:
| القيمة الثابتة | Value | الوصف |
|---|---|---|
| vbSunday | 1 | الأحد |
| vbMonday | 2 | الاثنين |
| vbالثلاثاء | 3 | الثلاثاء |
| vbWednesday | 4 | الأربعاء |
| vbالخميس | 5 | الخميس |
| vbFriday | 6 | الجمعة |
| vbالسبت | 7 | السبت |
ملاحظات
إذا كان إعداد خاصية Calendar ميلاديا، فإن العدد الصحيح الذي يتم إرجاعه يمثل اليوم الميلادي في الأسبوع لوسيطة التاريخ. إذا كان التقويم هجريا، فإن العدد الصحيح الذي يتم إرجاعه يمثل اليوم الهجري في الأسبوع لوسيطة التاريخ. بالنسبة للتواريخ الهجرية، يكون رقم الوسيطة أي تعبير رقمي يمكن أن يمثل تاريخا و/أو وقتا من 1/1/100 (ميلادي أغسطس 2، 718) حتى 4/3/9666 (الميلادي ديسمبر 31، 9999).
أمثلة عن الاستعلام
| التعبير | النتائج |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | ترجع هذه الدالة القيم من الحقل "تاريخ البيع" والرقم الذي يمثل "يوم الأسبوع" لقيم التاريخ هذه. (يعتبر يوم الأحد بشكل افتراضي اليوم الأول من الأسبوع؛ 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | ترجع هذه الدالة القيم من الحقل "تاريخ البيع" والرقم الذي يمثل "يوم الأسبوع" لقيم التاريخ هذه. (مع اعتبار يوم الاثنين هو اليوم الأول من الأسبوع). |
مثال VBA
ملاحظة
توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية ل Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد "مرجع المطور" في القائمة المنسدلة بجوار "بحث" وأدخل مصطلح أو أكثر في مربع البحث.
يستخدم هذا المثال الدالة Weekday للحصول على يوم من أيام الأسبوع من تاريخ محدد.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.