DateDiff 함수

DateDiff 함수

두 날짜 사이의 간격 수를 반환합니다.

DateDiff(interval, date1, date2 [,firstdayofweek[, firstweekofyear]])

DateDiff 함수 구문은 아래 인수를 가집니다.

인수

interval

필수적인 요소. date1과 date2 사이의 차이를 계산하는 데 사용할 interval의 문자식입니다. 그 값에 대해서는 아래의 설정을 참조하십시오.

date1, date2

필수적인 요소. 날짜식에서 계산에 사용할 두 날짜입니다.

firstdayofweek

선택적인 요소. 평일을 지정하는 상수로 지정하지 않으면 일요일로 간주합니다. 그 값에 대해서는 아래의 설정을 참조하십시오.

firstweekofyear

선택적인 요소. 연도를 기준으로 한 첫째 주를 지정하는 상수입니다. 지정하지 않으면 1월 1일을 포함하는 주를 첫째 주로 간주합니다. 그 값에 대해서는 아래의 설정을 참조하십시오.

설정

interval 인수의 값은 아래와 같습니다.

설정	설명
yyyy	년
q	분기
m	월
y	일(일년 기준)
d	일
w	요일
ww	주(일년 기준)
h	시
n	분
s	초

firstdayofweek 인수의 값은 아래와 같습니다.

상수	값	설명
vbUseSystem	0	NLS(National Language Support) API 설정 사용
vbSunday	1	일요일(기본값)
vbMonday	2	월요일
vbTuesday	3	화요일
vbWednesday	4	수요일
vbThursday	5	목요일
vbFriday	6	금요일
vbSaturday	7	토요일

firstweekofyear 인수의 값은 아래와 같습니다.

상수	값	설명
vbUseSystem	0	NLS(National Language Support) API 설정 사용
vbFirstJan1	1	1월 1일을 포함하는 주에서 시작(기본값)
vbFirstFourDays	2	새해의 처음 4일을 포함하는 주에서 시작
vbFirstFullWeek	3	새해의 처음 한 주일(7일)을 포함하는 주에서 시작

참고

DateDiff 함수를 사용하면 두 날짜 사이에 얼마만한 시간 간격이 있는지를 알 수 있습니다. 예를 들어 DateDiff 함수를 사용하여 두 날짜 사이의 일 수 또는 오늘부터 올해 말까지의 주일 수를 계산할 수 있습니다.

date1과 date2 사이의 날짜 수를 계산하려면 연도를 기준으로 한 일("y")이나 일("d")을 사용할 수 있습니다. interval이 요일("w")이면 DateDiff 함수는 두 날짜 사이의 주일 수를 반환합니다. date1이 월요일인 경우 DateDiff 함수는 date2까지의 월요일 수를 계산합니다. 즉, date1이 아니라 date2를 계산합니다. 그러나 interval이 주("ww")인 경우 DateDiff 함수는 두 날짜 사이의 달력 상의 주일 수를 반환합니다. 즉, date1에서 date2 사이의 일요일 수를 계산합니다. DateDiff 함수에서는 date2가 일요일이면 date2를 계산하지만, date1도 일요일인 경우 date1은 계산하지 않습니다.

date1이 date2보다 더 나중의 시점인 경우, DateDiff 함수는 음수를 반환합니다.

firstdayofweek 인수는 "w" 및 "ww" 간격 기호를 사용하는 계산에 영향을 미칩니다.

date1이나 date2가 날짜 리터럴인 경우 지정한 연도는 해당 날짜의 영구적인 요소가 됩니다. 그러나 date1이나 date2가 인용 부호(" ")로 둘러 싸이고 해당 연도를 생략할 경우 date1이나 date2 식을 계산할 때마다 사용자의 코드에 현재 연도가 삽입됩니다. 이런 방식으로 다음 연도에도 사용할 수 있는 코드를 작성할 수 있습니다.

12월 31일을 바로 다음 해의 1월 1일과 비교할 경우 단 하루가 경과했을지라도 DateDiff는 년("yyyy") 인수에 1을 반환합니다.

아래 예제에서 DateDiff 함수는 주어진 날짜로부터 현재까지의 경과일을 표시합니다.

Function DiffADate(theDate)
   DiffADate = "경과일: " & DateDiff("d", Now, theDate)
End Function