DATEPART(SSIS)
날짜의 특정 부분을 나타내는 정수를 반환합니다.
구문
DATEPART(datepart, date)
인수
datepart
새 값을 반환할 날짜 부분을 지정하는 매개 변수입니다.date
유효한 날짜 또는 날짜 형식의 문자열을 반환하는 식입니다.
결과 형식
DT_I4
주의
인수가 Null이면 DATEPART 결과도 Null입니다.
날짜 리터럴은 다음의 날짜 데이터 형식 중 하나로 명시적 캐스팅되어야 합니다. 자세한 내용은 Integration Services 데이터 형식을 참조하십시오.
[!참고]
날짜 리터럴이 DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 및 DT_DBTIME2 날짜 데이터 형식 중 하나로 명시적 캐스팅되면 식의 유효성 검사가 실패합니다.
다음 표에서는 식 계산기가 인식하는 날짜 부분 및 약어를 나열합니다. 날짜 부분 이름은 대/소문자를 구분하지 않습니다.
날짜 부분 |
약어 |
|---|---|
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 |
예
이 예에서는 날짜 리터럴의 월을 나타내는 정수가 반환됩니다. 날짜 형식이 "mm/dd/yyyy"이면 이 예에서는 11이 반환됩니다.
DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")
이 예에서는 ModifiedDate 열의 일 부분을 나타내는 정수를 반환합니다.
DATEPART("dd", ModifiedDate)
이 예에서는 현재 날짜의 연도를 나타내는 정수를 반환합니다.
DATEPART("yy",GETDATE())