DATEADD(SSIS)
날짜에서 지정한 날짜 부분에 날짜 또는 시간 간격을 나타내는 숫자를 더한 후 새로운 DT_DBTIMESTAMP 값을 반환합니다. 숫자 매개 변수는 정수로 계산되고 날짜 매개 변수는 유효한 날짜여야 합니다.
구문
DATEADD(datepart, number, date)
인수
datepart
숫자를 더할 날짜 부분을 지정하는 매개 변수입니다.number
datepart에 더해지는 값입니다. 값은 식을 구문 분석할 때 알려진 정수 값이어야 합니다.date
유효한 날짜 또는 날짜 형식의 문자열을 반환하는 식입니다.
결과 형식
DT_DBTIMESTAMP
주의
다음 표에서는 식 계산기가 인식하는 날짜 부분 및 약어를 나열합니다. 날짜 부분 이름은 대/소문자를 구분하지 않습니다.
날짜 부분 |
약어 |
|---|---|
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 |
Second |
ss, s |
Millisecond |
Ms |
식을 구문 분석할 때 number 인수를 사용할 수 있어야 합니다. 인수는 상수 또는 변수일 수 있습니다. 식을 구문 분석할 때 값을 알 수 없으므로 열 값을 사용할 수 없습니다.
datepart 인수는 따옴표로 묶어야 합니다.
날짜 리터럴은 다음의 날짜 데이터 형식 중 하나로 명시적 캐스팅되어야 합니다. 자세한 내용은 Integration Services 데이터 형식을 참조하십시오.
[!참고]
날짜 리터럴이 DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 및 DT_DBTIME2 날짜 데이터 형식 중 하나로 명시적 캐스팅되면 식의 유효성 검사가 실패합니다.
인수가 Null이면 DATEADD 결과도 Null입니다.
날짜가 잘못되었거나 날짜 또는 시간 단위가 문자열이 아니거나 증분이 고정 정수가 아니면 오류가 발생합니다.
예
이 예에서는 현재 날짜에 1개월을 더합니다.
DATEADD("Month", 1,GETDATE())
이 예에서는 ModifiedDate 열의 날짜에 21일을 더합니다.
DATEADD("day", 21, ModifiedDate)
이 예에서는 리터럴 날짜에 2년을 더합니다.
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")