datepart()

날짜에서 지정한 날짜 구성요소를 추출하여 정수로 반환합니다.

문법

매개변수

DATE

날짜를 반환하는 표현식입니다.

DATEPART

추출할 날짜 구성요소를 나타내는 상수 문자열입니다. 지원하는 값은 다음과 같습니다.

설명

datepart() 함수는 DATE에서 DATEPART로 지정한 구성요소를 추출합니다. epoch를 지정하면 64비트 정수를 반환하고, 그 외에는 32비트 정수를 반환합니다.

DATE가 null이거나 날짜 타입이 아닌 경우 null을 반환합니다.

오류 코드

90880

DATEPART가 null이거나 문자열이 아닌 경우 발생합니다.

90881

DATEPART 값이 유효하지 않은 경우 발생합니다. type 파라미터에 잘못된 유형 지시자가 포함됩니다.

사용 예

이 사용 예에서 조회하는 WEB_APACHE_SAMPLE 테이블을 준비하려면 쿼리 실습용 데이터를 참고하세요.

1. 접근 로그 시각에서 시(hour)를 추출합니다.

   table limit=5 WEB_APACHE_SAMPLE | eval result = datepart(_time, "hour")
   | fields _time, result
   

2. 접근 로그 시각에서 월을 추출합니다.

   table limit=5 WEB_APACHE_SAMPLE | eval result = datepart(_time, "mon")
   | fields _time, result
   

3. 접근 로그 시각의 Unix epoch 값을 추출합니다.

   table limit=5 WEB_APACHE_SAMPLE | eval result = datepart(_time, "epoch")
   | fields _time, result
   

4. NULL 입력

   json "{}" | eval result = datepart(null, "year")
   | # result: null
   

호환성

datepart() 함수는 소나 4.0 이전 버전부터 제공되었습니다.