지정된 시간 간격이 추가된 날짜가 포함된 변형 (날짜)을 반환합니다.
구문
DateAdd(interval, number, date)
함수에는 DateAdd 다음과 같은 인수가 있습니다.
| 인수 | 설명 |
|---|---|
interval |
필수 요소입니다. 추가할 시간 간격인 문자열 식입니다. |
number |
필수 요소입니다. 추가할 간격의 수인 숫자 식입니다. 미래의 날짜를 가져오는 것은 양수일 수도 있고 과거의 날짜를 가져오는 것은 음수일 수 있습니다. |
date |
필수 요소입니다. 간격이 추가되는 날짜를 나타내는 변형(날짜) 또는 리터럴입니다. |
설정
interval 인수의 설정은 다음과 같습니다.
| 설정 | 설명 |
|---|---|
yyyy |
년 |
q |
분기 |
m |
월 |
y |
연중 날짜 |
d |
일 |
w |
Weekday |
ww |
주 |
h |
시간 |
n |
분 |
s |
초 |
주의
이 DateAdd 함수를 사용하여 날짜에서 지정된 시간 간격을 더하거나 뺄 수 있습니다. 예를 들어 오늘부터 30일 후의 날짜 또는 지금으로부터 45분 후의 시간을 계산하는 데 사용할 DateAdd 수 있습니다.
에 일을 date추가하려면 일("y"), 일("d") 또는 요일("w")을 사용할 수 있습니다.
DateAdd 이 함수는 잘못된 날짜를 반환하지 않습니다. 다음 예제에서는 1월 31일에 1개월을 더합니다.
DateAdd("m", 1, "31-Jan-95")
이 경우 DateAdd 31-Feb-95가 아닌 28-Feb-95를 반환합니다. 31-Jan-96이면 date 1996년이 윤년이므로 29-Feb-96을 반환합니다.
계산된 날짜가 100년 앞에 있는 경우, 즉 에 있는 date연도보다 더 많은 연도를 뺄 경우 오류가 발생합니다.
Long 값이 아닌 경우 number 식을 계산하기 전에 가장 가까운 정수로 반올림합니다.
참고
의 반환 DateAdd 값 형식은 인수에 전달된 형식이 아닌 제어판 설정에 의해 결정됩니다date.
참고
의 경우 date속성 설정이 Calendar 양력인 경우 제공된 날짜는 양력이어야 합니다. 일정이 회교식인 경우 제공된 날짜는 회교식이어야 합니다. 월 값이 이름이면 이름은 현재 Calendar 속성 설정과 일치해야 합니다. 충돌 가능성을 줄이려면 월 값을 간단한 날짜 형식으로 입력합니다.
쿼리 예제
| Expression | 결과 |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
필드의 날짜 값에 1년을 더합니다 DateofSale . |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
필드의 날짜 값 DateofSale 에서 1년을 뺍니다. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
필드의 날짜 값 DateofSale 에 10일을 더하고 열의 결과를 반환합니다.NewDate |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
필드의 날짜 값 DateofSale 에서 1주 또는 7일을 빼고 열의 결과를 반환합니다.NewDate |
VBA 예제
참고
VBA(Visual Basic for Applications) 모듈에서 이 함수를 사용하는 경우를 예로 들어 보겠습니다. 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