הפונקציה DatePart

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

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

תחביר

DatePart(interval, date [, firstday ofweek] [, firstweek ofyear] )

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

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

הגדרות

לארגומנט המרווח יש את ההגדרות הבאות:

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

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

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

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

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

הערות

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

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

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

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

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

ביטוי	תוצאות
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	הפונקציה מחזירה את ה'שנה' של ערכי התאריכים של השדה "DateofSale".
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	הפונקציה מחזירה את ה'רבעון' (בהתבסס על שנת לוח שנה) של ערכי התאריכים של השדה "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;	הפונקציה מחזירה את ה'שעה' של ערכי התאריכים של השדה "DateTime".
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;	החזרת ה'דקות' של ערכי התאריכים של השדה "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

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