החזרת משתנה (מספר שלם) המכיל מספר שלם המייצג את היום בשבוע.
תחביר
Weekday( date [, firstdayofweek ] )
תחביר הפונקציה Weekday מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|
date |
נדרש. משתנה, ביטוי מספרי, ביטוי מחרוזת או כל שילוב של אלה שעשוי לייצג תאריך. אם התאריך מכיל Null, מוחזר Null. |
|
היום הראשון בשבוע |
אופציונלי. תבנית קבוע המציינת את היום הראשון בשבוע. אם לא צוין, הפונקציה מניחה את vbSunday . |
הגדרות
הארגומנט היום הראשון בשבוע כולל את ההגדרות הבאות:
|
קבוע |
Value |
תיאור |
|
vbUseSystem |
0 |
השתמש בהגדרת ה- API של NLS. |
|
vbSunday |
1 |
יום ראשון (ברירת מחדל) |
|
vbMonday |
2 |
שני |
|
יום שלישי של vb |
3 |
שלישי |
|
vbWednesday |
4 |
רביעי |
|
vbThursday |
5 |
חמישי |
|
יום שישי של vb |
6 |
שישי |
|
vbSaturday |
7 |
שבת |
ערכי החזרה
הפונקציה Weekday יכולה להחזיר כל אחד מערכים אלה:
|
קבוע |
Value |
תיאור |
|
vbSunday |
1 |
ראשון |
|
vbMonday |
2 |
שני |
|
יום שלישי של vb |
3 |
שלישי |
|
vbWednesday |
4 |
רביעי |
|
vbThursday |
5 |
חמישי |
|
יום שישי של vb |
6 |
שישי |
|
vbSaturday |
7 |
שבת |
הערות
אם הגדרת המאפיין לוח שנה היא לועזית, המספר השלם המוחזר מייצג את היום הלועזי בשבוע עבור הארגומנט date. אם לוח השנה הוא איסלמי, המספר השלם המוחזר מייצג את היום האיסלמי בשבוע עבור הארגומנט date. עבור תאריכים איסלמיים, מספר הארגומנט הוא כל ביטוי מספרי שעשוי לייצג תאריך ו/או שעה מ- 1/1/100 (2 באוגוסט הלועזי, 718) עד 3/4/9666 (31 בדצמבר הלועזי, 9999).
דוגמאות שאילתה
|
Expression |
תוצאות |
|
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; |
הפונקציה מחזירה את הערכים מהשדות "DateofSale" ומספר המייצג את 'Weekday' של ערכי תאריכים אלה. (כברירת מחדל, יום ראשון נחשב ליום הראשון בשבוע; 1). |
|
SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; |
הפונקציה מחזירה את הערכים מהשדות "DateofSale" ומספר המייצג את 'Weekday' של ערכי תאריכים אלה. (בהתחשב ביום שני להיום הראשון בשבוע). |
דוגמה ל- 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.
