החזרת משתנה (תאריך) המכיל תאריך עם מרווח זמן שצוין שנוסף.
תחביר
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ל- , באפשרותך להשתמש ביום בשנה ("y"), ביום ("d") או בימי חול ("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