`dateadd` 함수

아티클
04/22/2024

적용 대상: 검사 '예'로 표시 Databricks SQL Databricks Runtime 10.4 LTS 이상

valueunit을(를) 타임스탬프 expr에 추가합니다. 이 함수는 timestampadd 함수의 동의어입니다.

구문

dateadd(unit, value, expr)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY | DAYOFYEAR |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

인수

unit: 측정 단위입니다.
value: expr에 추가할 unit의 수가 포함된 수식입니다.
expr: TIMESTAMP 식입니다.

반품

TIMESTAMP입니다.

value가 음수이면 expr에서 차감됩니다. unit이 MONTH, QUARTER 또는 YEAR인 경우 결과의 일 부분이 유효한 날짜가 되도록 조정됩니다.

결과가 지원되는 타임스탬프 범위를 벗어나면 함수는 오버플로 오류를 반환합니다.

예제

> SELECT dateadd(MICROSECOND, 5, TIMESTAMP'2022-02-28 00:00:00');
 2022-02-28 00:00:00.000005

-- March 31. 2022 minus 1 month yields February 28. 2022
> SELECT dateadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000