הפונקציה DatePart

החזרת משתנה (‏מספר שלם) המכיל את החלק שצוין של תאריך נתון.

אזהרה קיימת בעיה בשימוש בפונקציה זו. ביום שני האחרון בכמה שנים קלנדריות ניתן להחזיר כשבוע 53 כאשר הוא אמור להיות שבוע 1. לקבלת מידע נוסף ופתרון, ראה הפונקציות Format או DatePart יכולות להחזיר מספר שבוע שגוי עבור יום שני שעבר בשנה.

תחביר

DatePart(interval, date [, firstdayofweek] [, השבוע הראשון בשנה] )

תחביר הפונקציה DatePart מכיל את הארגומנטים הבאים:

ארגומנט	תיאור
interval	נדרש. ביטוי מחרוזת שהוא מרווח הזמן שברצונך להחזיר.
תאריך	נדרש. ערך משתנה (תאריך) שברצונך להעריך.
היום הראשון בשבוע	אופציונלי. קבוע המציין את היום הראשון בשבוע. אם לא צוין, הפונקציה מניחה את יום ראשון.
השבוע הראשון בשנה	אופציונלי. קבוע המציין את השבוע הראשון בשנה. אם לא צוין, ההנחה היא שהשבוע הראשון הוא השבוע שבו חל 1 בינואר.

הגדרות

ארגומנט מרווח הזמן כולל את ההגדרות הבאות:

הגדרה	תיאור
yyyy	שנה
q	רבעון
m	חודש
y	יום בשנה
d	יום
W	Weekday
ww	שבוע
H	שעה
n	דקה
s	שניה

הארגומנט היום הראשון בשבוע כולל את ההגדרות הבאות:

קבוע	Value	תיאור
vbUseSystem	0	השתמש בהגדרת ה- API של NLS.
vbSunday	1	יום ראשון (ברירת מחדל)
vbMonday	2	שני
יום שלישי של vb	3	שלישי
vbWednesday	4	רביעי
vbThursday	5	חמישי
יום שישי של vb	6	שישי
vbSaturday	7	שבת

הארגומנט השבוע הראשון בשנה כולל את ההגדרות הבאות:

קבוע	Value	תיאור
vbUseSystem	0	השתמש בהגדרת ה- API של NLS.
vbFirstJan1	1	התחל משבוע שבו חל 1 בינואר (ברירת מחדל).
vbFirstFourDays	2	התחל מהשבוע הראשון הכולל לפחות ארבעה ימים בשנה החדשה.
vbFirstFullWeek	3	התחל מהשבוע המלא הראשון בשנה.

הערות

באפשרותך להשתמש בפונקציה DatePart כדי להעריך תאריך ולהחזיר מרווח זמן ספציפי. לדוגמה, באפשרותך להשתמש ב- DatePart כדי לחשב את היום בשבוע או את השעה הנוכחית.

הארגומנט היום הראשון בשבוע משפיע על חישובים המשתמשים בסימני מרווחי הזמן "w" ו- "ww".

אם date הוא ליטרל של תאריך, השנה שצוינה הופכת לחלק קבוע של תאריך זה. עם זאת, אם date מוקף במרכאות כפולות (" "), ואתה השמטת השנה, השנה הנוכחית נוספת לקוד שלך בכל פעם שביטוי התאריך מוערך. הדבר מאפשר לכתוב קוד שניתן להשתמש בו בשנים שונות.

חלק התאריך המוחזר הוא ביחידות פרק הזמן של לוח השנה הערבי הנוכחי. לדוגמה, אם לוח השנה הנוכחי הוא איסלמי ותאריך ההחזרה הוא השנה, ערך השנה הוא שנה איסלמית.

דוגמאות שאילתה

ביטוי	תוצאות
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	החזרת 'Year' של ערכי התאריך של השדה "DateofSale".
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	הפונקציה מחזירה את ה- 'Quarter' (בהתבסס על שנת לוח השנה) של ערכי התאריך של השדה "DateofSale".
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	החזרת 'יום בשנה' (1 עד 365) של ערכי התאריך של השדה "DateofSale".
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;	הפונקציה מחזירה את ה'יום' של ערכי התאריך של השדה "DateofSale".
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;	החזרת 'Weekday' (מ- 1 עד 7 כאשר 1 מייצג את יום ראשון) של ערכי התאריך של השדה "DateofSale".
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	החזרת 'מספר שבוע' (מ- 1 עד 52) של ערכי התאריך של השדה "DateofSale".
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	הפונקציה מחזירה את ה- 'Hour' של ערכי התאריך של השדה "DateTime".
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;	החזרת 'Minutes' של ערכי התאריך של השדה "DateTime".
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	החזרת ה'שניות' של ערכי התאריך של השדה "DateTime".

דוגמה ל- VBA

דוגמה זו לוקחת תאריך, והשימוש בפונקציה DatePart מציג את רבעון השנה שבו היא מתרחשת.

Dim TheDate As Date    ' Declare variables.
Dim Msg    
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

בחירת פונקציית התאריך המתאימה