다음을 통해 공유


DATEDIFF(SSIS 식)

적용 대상: SQL Server Azure Data Factory의 SSIS Integration Runtime

지정한 두 날짜 사이에 있는 날짜 및 시간 경계의 수를 반환합니다. datepart 매개 변수는 비교할 날짜 및 시간 범위를 식별합니다.

구문

  
DATEDIFF(datepart, startdate, endate)  

인수

datepart
비교해 보고 값을 반환할 날짜 부분을 지정해 주는 매개 변수입니다.

startdate
간격의 시작 날짜입니다.

endate
간격의 종료 날짜입니다.

결과 형식

DT_I4

설명

다음 표에서는 식 계산기에서 인식하는 날짜 부분과 약어가 나열되어 있습니다.

DatePart 약어
Year yy, yyyy
Quarter qq, q
Month mm, m
Dayofyear dy, y
Day dd, d
Week wk, ww
Weekday dw, w
Hour Hh
Minute mi, n
둘째 ss, s
Millisecond Ms

DATEDIFF가 null이면 null 결과를 반환합니다.

날짜 리터럴은 날짜 데이터 형식 중 하나에 명시적으로 캐스팅되어야 합니다. 자세한 내용은 Integration Services 데이터 형식을 참조하세요.

올바른 날짜가 아니거나, 날짜 또는 시간 단위가 문자열이 아니거나, 시작 날짜가 날짜가 아니거나, 종료 날짜가 날짜가 아니면 오류가 발생합니다.

종료 날짜가 시작 날짜보다 빠르면 음수가 반환됩니다. 시작 날짜와 종료 날짜가 같거나 동일한 간격 내에 있으면 0이 반환됩니다.

SSIS 식 예제

이 예에서는 두 날짜 리터럴 사이의 일 수를 계산합니다. 날짜가 "mm/dd/yyyy"형식인 경우에 함수는 7이 반환됩니다.

DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")  

이 예시에서는 날짜 리터럴과 현재 날짜 사이의 개월 수를 반환합니다.

DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())  

이 예시에서는 ModifiedDate 열의 날짜와 YearEndDate 변수 사이에서의 주수를 반환합니다. YearEndDate날짜 데이터 형식이 있는 경우에는 명시적 캐스팅이 필요하지 않습니다.

DATEDIFF("Week", ModifiedDate,@YearEndDate)  

참고 항목

DATEADD(SSIS 식)
DATEPART(SSIS 식)
DAY(SSIS 식)
MONTH(SSIS 식)
YEAR (SSIS 식)
함수(SSIS 식)