إرجاع متغير (عدد صحيح) يحتوي على رقم صحيح يمثل يوماً من الأسبوع.
بناء الجملة
Weekday( date [, firstdayofweek ] )
يحتوي بناء جملة الدالة Weekday على هذه الوسيطات:
|
الوسيطة |
الوصف |
|
تاريخ |
مطلوبة. متغير أو تعبير رقمي أو تعبير السلسلة أو أي مجموعة من هذه التي يمكن أن تمثل تاريخا. إذا كان التاريخ يحتوي على Null، يتم إرجاع Null . |
|
أول يوم من الأسبوع |
اختيارية. ثابت يحدد اليوم الأول من الأسبوع. إذا لم يتم تحديده، يتم افتراض vbSunday . |
الإعدادات
تحتوي وسيطة firstdayofweek على هذه الإعدادات:
|
ثابت |
قيمة |
الوصف |
|
نظام vbUseSystem |
0 |
استخدم إعداد NLS API. |
|
vbSunday |
1 |
الأحد (افتراضي) |
|
vbMonday |
2 |
الاثنين |
|
vbTuesday |
3 |
الثلاثاء |
|
vbWednesday |
4 |
الأربعاء |
|
vbThursday |
5 |
الخميس |
|
vbFriday |
6 |
الجمعة |
|
vbSaturday |
7 |
السبت |
إرجاع القيم
يمكن أن ترجع الدالة Weekday أيا من هذه القيم:
|
ثابت |
قيمة |
الوصف |
|
vbSunday |
1 |
الأحد |
|
vbMonday |
2 |
الاثنين |
|
vbTuesday |
3 |
الثلاثاء |
|
vbWednesday |
4 |
الأربعاء |
|
vbThursday |
5 |
الخميس |
|
vbFriday |
6 |
الجمعة |
|
vbSaturday |
7 |
السبت |
ملاحظات
إذا كان إعداد خاصية التقويم ميلاديا، فإن العدد الصحيح الذي تم إرجاعه يمثل اليوم الميلادي من الأسبوع كوسيطة التاريخ. إذا كان التقويم هو الهجري، فإن العدد الصحيح الذي تم إرجاعه يمثل اليوم الهجري من الأسبوع كوسيطة التاريخ. بالنسبة للتواريخ الهجرية، رقم الوسيطة هو أي تعبير رقمي يمكن أن يمثل تاريخا و/أو وقت من 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.
