החזרת משתנה (תאריך) המכיל תאריך שאליו נוסף מרווח זמן שצוין.
תחביר
DateAdd ( interval, number, date )
תחביר הפונקציה DateAdd מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|---|---|
|
interval |
נדרש. ביטוי מחרוזת שהוא מרווח הזמן שברצונך להוסיף. |
|
number |
נדרש. ביטוי מספרי שהוא מספר המרווחים שברצונך להוסיף. היא יכולה להיות חיובית (כדי לקבל תאריכים בעתיד) או שלילית (כדי לקבל תאריכים בעבר). |
|
date |
נדרש. משתנה (תאריך) או ליטרל המייצג תאריך שאליו נוסף מרווח הזמן. |
הגדרות
מרווח הזמןארגומנט הגדרות אלה:
|
הגדרה |
תיאור |
|---|---|
|
yyyy |
שנה |
|
q |
רבעון |
|
m |
חודש |
|
y |
יום בשנה |
|
d |
יום |
|
W |
Weekday |
|
ww |
שבוע |
|
H |
שעה |
|
n |
דקה |
|
s |
שניה |
הערות
באפשרותך להשתמש בפונקציה DateAdd כדי להוסיף או לחסר מרווח זמן שצוין מתאריך. לדוגמה, באפשרותך להשתמש ב - DateAdd כדי לחשב תאריך החל מהיום או בשעה של 45 דקות מעכשיו.
כדי להוסיף ימים לתאריך, באפשרותך להשתמש ביום בשנה ("y"), ביום ("d") או ביום חול ("w").
הפונקציה DateAdd לא תחזיר תאריך לא חוקי. הדוגמה הבאה מוסיפה חודש אחד ל- 31 בינואר:
DateAdd("m", 1, "31-Jan-95")
במקרה זה, DateAdd מחזיר 28-פברואר-95, לא 31-פברואר-95. אם התאריך הוא 31-ינואר-96, הפונקציה מחזירה 29-פברואר-96 מכיוון ש- 1996 היא שנה מעוברת.
אם התאריך המחושב קודם לשנה 100 (לדוגמה, אתה מחסיר יותר שנים מהתאריך ), מתרחשת שגיאה.
אם number אינו ערך ארוך, הוא מעוגל למספר השלם הקרוב ביותר לפני הערכה.
הערה: תבנית הערך המוחזר עבור DateAdd נקבעת על-ידי הגדרות לוח הבקרה, ולא לפי התבנית המועברת בארגומנט date .
הערה: עבור תאריך, אם הגדרת המאפיין לוח שנה היא לועזית, התאריך שסופק חייב להיות לועזי. אם לוח השנה הוא איסלמי, התאריך שסופק חייב להיות איסלמי. אם ערכי חודש הם שמות, השם חייב להיות עקבי בהגדרת המאפיין הנוכחית של לוח השנה. כדי למזער את האפשרות לשמות חודשים המתנגשים עם הגדרת המאפיין הנוכחית של לוח השנה, הזן ערכי חודש מספרי (תבנית תאריך קצר).
דוגמאות שאילתה
|
Expression |
תוצאות |
|---|---|
|
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; |
מחזירה את התוצאות בעמודה "NewDate" על-ידי הוספת 10 ימים להערכים של השדה "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
החזרת התוצאות בעמודה "NewDate" על-ידי חיסור שבוע אחד (7 ימים) מתוך ערכי התאריך של השדה "DateofSale". |
דוגמה ל- 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
