날짜에서 지정한 날짜 부분에 날짜 또는 시간 간격을 나타내는 숫자를 더한 후 새로운 DT_DBTIMESTAMP 값을 반환합니다.Returns a new DT_DBTIMESTAMP value after adding a number that represents a date or time interval to the specified datepart in a date. 숫자 매개 변수는 정수로 계산되고 날짜 매개 변수는 유효한 날짜여야 합니다.The number parameter must evaluate to an integer, and the date parameter must evaluate to a valid date.


DATEADD(datepart, number, date)  


숫자를 더할 날짜 부분을 지정하는 매개 변수입니다.Is the parameter that specifies which part of the date to add a number to.

datepart에 더해지는 값입니다.Is the value used to increment datepart. 값은 식을 구문 분석할 때 알려진 정수 값이어야 합니다.The value must be an integer value that is known when the expression is parsed.

유효한 날짜 또는 날짜 형식의 문자열을 반환하는 식입니다.Is an expression that returns a valid date or a string in date format.

결과 형식Result Types



다음 표에서는 식 계산기가 인식하는 날짜 부분 및 약어를 나열합니다.The following table lists the dateparts and abbreviations recognized by the expression evaluator. 날짜 부분 이름은 대/소문자를 구분하지 않습니다.Datepart names are not case sensitive.

날짜 부분Datepart 약어Abbreviations
YearYear yy, yyyyyy, yyyy
QuarterQuarter qq, qqq, q
MonthMonth mm, mmm, m
DayofyearDayofyear dy, ydy, y
DayDay dd, ddd, d
WeekWeek wk, wwwk, ww
WeekdayWeekday dw, wdw, w
HourHour HhHh
MinuteMinute mi, nmi, n
둘째Second ss, sss, s
MillisecondMillisecond MsMs

식을 구문 분석할 때 number 인수를 사용할 수 있어야 합니다.The number argument must be available when the expression is parsed. 인수는 상수 또는 변수일 수 있습니다.The argument can be a constant or a variable. 식을 구문 분석할 때 값을 알 수 없으므로 열 값을 사용할 수 없습니다.You cannot use column values because the values are not known when the expression is parsed.

datepart 인수는 따옴표로 묶어야 합니다.The datepart argument must be enclosed by quotation marks.

날짜 리터럴은 다음의 날짜 데이터 형식 중 하나로 명시적 캐스팅되어야 합니다.A date literal must be explicitly cast to one of the date data types. 자세한 내용은 Integration Services Data Types을 참조하세요.For more information, see Integration Services Data Types.

인수가 Null이면 DATEADD 결과도 Null입니다.DATEADD returns a null result if the argument is null.

날짜가 잘못되었거나 날짜 또는 시간 단위가 문자열이 아니거나 증분이 고정 정수가 아니면 오류가 발생합니다.Errors occur if a date is invalid, if the date or time unit is not a string, or if the increment is not a static integer.

SSIS 식 예SSIS Expression Examples

이 예에서는 현재 날짜에 1개월을 더합니다.This example adds one month to the current date.

DATEADD("Month", 1,GETDATE())  

이 예에서는 ModifiedDate 열의 날짜에 21일을 더합니다.This example adds 21 days to the dates in the ModifiedDate column.

DATEADD("day", 21, ModifiedDate)  

이 예에서는 리터럴 날짜에 2년을 더합니다.This example adds 2 years to a literal date.

DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")  

참고 항목See Also

DAY(SSIS 식) DAY (SSIS Expression)
YEAR(SSIS 식) YEAR (SSIS Expression)
함수(SSIS 식)Functions (SSIS Expression)