החזרת משתנה (מספר שלם) המכיל מספר שלם המייצג את היום בשבוע.
תחביר
Weekday(date [, firstdayofweek ] )
תחביר הפונקציה Weekday מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| תאריך | נדרש. משתנה, ביטוי מספרי, ביטוי מחרוזת או כל שילוב של אלה שעשוי לייצג תאריך. אם התאריך מכיל 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 | שבת |
הערות
אם הגדרת Calendar היא לועזית, המספר השלם המוחזר מייצג את היום הלועזי בשבוע עבור הארגומנט date. אם לוח השנה הוא איסלמי, המספר השלם המוחזר מייצג את היום האיסלמי בשבוע עבור הארגומנט date. עבור תאריכים איסלמיים, מספר הארגומנט הוא כל ביטוי מספרי שעשוי לייצג תאריך ו/או שעה מ- 1/1/100 (2 באוגוסט הלועזי, 718) עד 3/4/9666 (31 בדצמבר הלועזי, 9999).
דוגמאות שאילתה
| ביטוי | תוצאות |
|---|---|
| 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.