إرجاع متغير (عدد صحيح) يحتوي على رقم صحيح يمثل يوماً من الأسبوع.
بناء الجملة
Weekday(date [, firstdayofweek ] )
يحتوي بناء جملة الدالة Weekday على هذه الوسيطات:
| الوسيطة | الوصف |
|---|---|
| تاريخ | مطلوبة. متغير أو تعبير رقمي أو تعبير سلسلة أو أي مجموعة من هذه التي يمكن أن تمثل تاريخا. إذا كان التاريخ يحتوي على Null، يتم إرجاع Null . |
| أول يوم من الأسبوع | اختيارية. ثابت يحدد اليوم الأول من الأسبوع. إذا لم يتم تحديده، يتم افتراض vbSunday . |
الإعدادات
تحتوي وسيطة firstdayofweek على هذه الإعدادات:
| ثابت | Value | الوصف |
|---|---|---|
| نظام vbUseSystem | 0 | استخدم إعداد NLS API. |
| vbSunday | 1 | الأحد (افتراضي) |
| vbMonday | 2 | الاثنين |
| vbTuesday | 3 | الثلاثاء |
| vbWednesday | 4 | الأربعاء |
| vbThursday | 5 | الخميس |
| vbFriday | 6 | الجمعة |
| vbSaturday | 7 | السبت |
إرجاع القيم
يمكن أن ترجع الدالة Weekday أيا من هذه القيم:
| ثابت | Value | الوصف |
|---|---|---|
| vbSunday | 1 | الأحد |
| vbMonday | 2 | الاثنين |
| vbTuesday | 3 | الثلاثاء |
| vbWednesday | 4 | الأربعاء |
| vbThursday | 5 | الخميس |
| vbFriday | 6 | الجمعة |
| vbSaturday | 7 | السبت |
ملاحظات
إذا كان إعداد الخاصية Calendar ميلاديا، فإن العدد الصحيح الذي تم إرجاعه يمثل اليوم الميلادي من الأسبوع كوسيطة التاريخ. إذا كان التقويم هو الهجري، فإن العدد الصحيح الذي تم إرجاعه يمثل اليوم الهجري من الأسبوع كوسيطة التاريخ. بالنسبة للتواريخ الهجرية، رقم الوسيطة هو أي تعبير رقمي يمكن أن يمثل تاريخا و/أو وقت من 1/1/100 (2 أغسطس الميلادي، 718) إلى 4/3/9666 (31 ديسمبر الميلادي، 9999).
أمثلة الاستعلام
| التعبير | النتائج |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | إرجاع القيم من الحقل "DateofSale" والرقم الذي يمثل "يوم الأسبوع" لقيم التاريخ هذه. (يعتبر يوم الأحد هو اليوم الأول من الأسبوع بشكل افتراضي؛ 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | إرجاع القيم من الحقل "DateofSale" والرقم الذي يمثل "يوم الأسبوع" لقيم التاريخ هذه. (بالنظر إلى يوم الاثنين باعتباره اليوم الأول من الأسبوع). |
مثال 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.