dateadd()

날짜에 지정한 단위만큼 더하거나 빼서 새로운 날짜를 반환합니다.

문법

매개변수

DATE

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

UNIT

가감할 시간 단위를 나타내는 문자열입니다. 지원하는 단위는 다음과 같습니다.

DELTA

DATE에 더하거나 뺄 정수값입니다. 양수이면 더하고, 음수이면 뺍니다.

설명

dateadd() 함수는 DATE에 지정한 단위(UNIT)만큼 DELTA를 더하거나 빼서 날짜를 반환합니다. 반환 타입은 날짜입니다.

DATE가 null이거나 날짜 타입이 아닌 경우 null을 반환합니다. UNIT이 유효하지 않은 경우 null을 반환합니다. DELTA가 정수가 아닌 경우 null을 반환합니다.

오류 코드

90620

인수 개수가 3개가 아닌 경우 발생합니다.

90621

UNIT 값이 유효하지 않은 경우 발생합니다. field 파라미터에 잘못된 단위가 포함됩니다.

90622

DELTA가 정수 타입이 아닌 상수인 경우 발생합니다. time 파라미터에 해당 값이 포함됩니다.

사용 예

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

1. 접근 로그 시각에 1일을 더합니다.

   table limit=5 WEB_APACHE_SAMPLE | eval result = dateadd(_time, "day", 1)
   | fields _time, result
   

2. 접근 로그 시각에서 3시간을 뺍니다.

   table limit=5 WEB_APACHE_SAMPLE | eval result = dateadd(_time, "hour", -3)
   | fields _time, result
   

3. NULL 입력

   json "{}" | eval result = dateadd(null, "hour", 1)
   | # result: null
   

호환성

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