datepart()

특정 시각에서 지정한 시간 단위(세기, 연, 월, 일, 요일, 등)에 해당하는 정수값을 추출합니다.

문법

datepart(DATE, DATEPART)
필수 매개변수
DATE
시간 타입을 반환하는 표현식. 다른 타입 값을 받으면 null을 반환합니다.
DATEPART
상수 문자열. 유형 지시자의 목록은 다음 표를 참조하십시오.

유형 지시자

유형 지시자타입설명예시 값
centuryint세기21
dayint날짜 (1~31)12
decadeint연도를 10으로 나눈 몫201
dowint한 주 내에서의 날 수. 일요일 (0), 토요일 (6)1
doyint한 해 내에서의 날 수163
epochlong1970년 1월 1일부터 날짜까지 경과한 초1497269156
hourint24시간 기준 시간 (0-23)21
isodowintISO 8601 기준 한 주 내에서의 날 수. 월요일 (1), 일요일 (7)1
isoyearintISO 8601 기준 한 해의 첫 월요일을 새해 첫 날로 인식한 년도2017
microsecondsint초를 포함한 마이크로초56371000
milleniumint밀레니엄 (천 년 단위)3
millisecondsint초를 포함한 밀리초56371
min, minuteint분 (0-59)5
mon, monthint월 (1-12)6
msecint초를 포함하지 않은 밀리초377
quarterint분기 (1-4)2
sec, secondsint초 (0-59)56
timezoneintUTC 기준 시간대 (초)32400
timezone_hourintUTC 기준 시간대 (시)9
timezone_minuteintUTC 기준 시간대 (분)0
weekintISO 8601 기준 한 해의 첫 월요일을 새해 첫 날로 인식한 주의 수24
yearint년도2017

사용 예

  1. "6월 1 2020 12:34:56"에서 연도에 해당하는 값을 추출

    json "{}" 
    | eval time=
        datepart(
        date("6월 1 2020 12:34:56",
        "MMM dd yyyy HH:mm:ss", "ko"),
        "year"
    )
    
  2. "6월 1 2020 12:34:56"에서 월에 해당하는 값을 추출

    json "{}" 
    | eval time=
        datepart(
        date("6월 1 2020 12:34:56",
        "MMM dd yyyy HH:mm:ss", "ko"),
        "mon"
    )
    
  3. "6월 1 2020 12:34:56"에서 유닉스 시간에 해당하는 값을 추출

    json "{}" 
    | eval time=datepart(
        date(
        "6월 1 2020 12:34:56", "MMM dd yyyy HH:mm:ss", "ko"),
        "epoch"
    )
        => 1590982496