지정된 시간 간격이 추가된 날짜가 들어 있는 Variant(Date)를 반환합니다.
구문
DateAdd ( interval, number, date )
DateAdd 함수 구문에는 다음과 같은 인수가 사용됩니다.
|
인수 |
설명 |
|---|---|
|
interval |
필수 요소입니다. 추가할 시간 간격인 문자열 식입니다. |
|
number |
필수 요소입니다. 추가할 간격의 수인 숫자 식입니다. 양수(나중에 날짜를 가져오기 위해) 또는 음수(과거의 날짜를 가져오기 위해)일 수 있습니다. |
|
date |
필수 요소입니다. 간격이 추가된 날짜를 나타내는 Variant(날짜) 또는 리터럴입니다. |
설정
인수 간격 에는 다음과 같은 설정이 있습니다.
|
설정 |
설명 |
|---|---|
|
yyyy |
년 |
|
q |
분기 |
|
m |
월 |
|
y |
연중 일 |
|
d |
일 |
|
w |
Weekday |
|
ww |
주 |
|
h |
시간 |
|
n |
분 |
|
s |
초 |
주의
DateAdd 함수를 사용하여 날짜에서 지정된 시간 간격을 추가하거나 뺄 수 있습니다. 예를 들어 DateAdd 를 사용하여 오늘부터 30일 또는 지금부터 45분 사이의 날짜를 계산할 수 있습니다.
날짜 에 일을 추가하려면 연도의 날("y"), 일("d") 또는 평일("w")을 사용할 수 있습니다.
DateAdd 함수는 잘못된 날짜를 반환하지 않습니다. 다음 예제에서는 1월 31일에 한 달을 추가합니다.
DateAdd("m", 1, "31-Jan-95")
이 경우 DateAdd 는 2월 95일 31-2월 95일이 아닌 28-2월 95일을 반환합니다. 날짜가 31-Jan-96이면 1996년이 윤년이므로 29-2월 96일을 반환합니다.
계산 날짜가 100년 이전인 경우(즉, 날짜보다 더 많은 연도를 빼면) 오류가 발생합니다.
number 가 Long 값이 아니면 평가되기 전에 가장 가까운 정수로 반올림됩니다.
참고: DateAdd의 반환 값 형식은 date 인수에 전달되는 형식이 아니라 제어판 설정에 따라 결정됩니다.
참고: 날짜의 경우 Calendar 속성 설정이 그레고리력인 경우 제공된 날짜는 그레고리력이어야 합니다. 일정이 Hijri인 경우 제공된 날짜는 Hijri여야 합니다. 월 값이 이름인 경우 이름은 현재 Calendar 속성 설정과 일치해야 합니다. 현재 Calendar 속성 설정과 충돌하는 월 이름의 가능성을 최소화하려면 숫자 월 값(짧은 날짜 형식)을 입력합니다.
쿼리 예제
|
Expression |
결과 |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 1년을 추가하여 결과를 반환합니다. |
|
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 작업에 대한 자세한 내용은 액세스 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
