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