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())