החזרת משתנה (תאריך) המכיל תאריך עם מרווח זמן שצוין.
תחביר
DateAdd(interval, number, date)
הפונקציה DateAdd מכילה את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
interval |
נדרש. ביטוי מחרוזת שהוא מרווח הזמן שברצונך להוסיף. |
number |
נדרש. ביטוי מספרי שהוא מספר המרווחים שברצונך להוסיף. השגת תאריכים בעתיד יכולה להיות חיובית או שלילית לקבלת תאריכים בעבר. |
date |
נדרש. משתנה (תאריך) או ליטרל המייצג את התאריך שאליו נוסף מרווח הזמן. |
הגדרות
הארגומנט כולל את ההגדרות interval הבאות:
| הגדרה | תיאור |
|---|---|
yyyy |
שנה |
q |
רבעון |
m |
חודש |
y |
יום בשנה |
d |
יום |
w |
Weekday |
ww |
שבוע |
h |
Hour |
n |
Minute |
s |
Second |
הערות
באפשרותך להשתמש בפונקציה DateAdd כדי לחבר או לחסר מרווח זמן שצוין מתאריך. לדוגמה, באפשרותך להשתמש כדי DateAdd לחשב תאריך בעוד 30 יום מהיום או שעה בעוד 45 דקות.
כדי להוסיף ימים ל- date, באפשרותך להשתמש ב- Day of Year ("y"), Day ("d") או Weekday ("w").
הפונקציה DateAdd לא תחזיר תאריך לא חוקי. הדוגמה הבאה מוסיפה חודש אחד ל- 31 בינואר:
DateAdd("m", 1, "31-Jan-95")
במקרה זה, DateAdd הפונקציה מחזירה 28-פברואר-95, לא 31-פברואר-95. אם date הוא 31-ינואר-96, הוא מחזיר 29-פברואר-96 מכיוון ש-1996 היא שנה מעוברת.
אם התאריך המחושב מופיע לפני השנה 100, כלומר אתה מחסר שנים רבות יותר מאשר ב date- , מתרחשת שגיאה.
אם number הערך אינו ארוך, Access מעגל אותו למספר השלם הקרוב ביותר לפני שהוא מעריך את הביטוי.
הערה
התבנית של ערך ההחזרה עבור DateAdd נקבעת על-ידי הגדרות לוח הבקרה, ולא על-ידי התבנית המועברת בארגומנטdate.
הערה
עבור date, אם הגדרת המאפיין Calendar היא לועזי, התאריך שסופק חייב להיות לועזי. אם לוח השנה הוא איסלמי, התאריך שסופק חייב להיות איסלמי. אם ערכי חודשים הם שמות, השם חייב להתאים להגדרת המאפיין הנוכחית Calendar . כדי להפחית את הסיכוי להתנגשויות, הזן ערכי חודשים מספריים בתבנית Short Date.
דוגמאות לשאילתות
| ביטוי | תוצאות |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
הוספת שנה אחת לערכי התאריכים בשדה DateofSale . |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
חיסור שנה אחת מערכי התאריכים בשדה DateofSale . |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
הוספת 10 ימים לערכי התאריכים בשדה DateofSale והחזרת התוצאות בעמודה NewDate . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
חיסור שבוע אחד או 7 ימים מערכי התאריכים בשדה DateofSale והחזרת התוצאות בעמודה NewDate . |
דוגמה ל- VBA
הערה
הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, עיין בחומר עזר בנושא Access VBA.
דוגמה זו משתמשת בתאריך כקלט ומשתמשת DateAdd בפונקציה כדי להציג את התאריך התואם מספר מוגדר של חודשים בעתיד.
Dim FirstDate As Date ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg