TIMESTAMPADD

TIMESTAMPADD

지정한 날짜 또는 시간 부분(part)에 대해 지정한 값을 날짜, 시간 또는 타임스탬프에 더해요. DATEADD의 별칭이에요.

출처: Snowflake SQL Reference - TIMESTAMPADD

본문

구문

TIMESTAMPADD( <date_or_time_part> , <time_value> , <date_or_time_expr> )

인자

• 더하려는 시간의 단위를 나타내요. 예를 들어 이틀을 더하려면 day를 지정해요. 이 측정 단위는 Supported date and time parts에 나열된 값 중 하나여야 해요.
• 더하려는 시간 단위의 수예요. 예를 들어 시간 단위가 day이고 이틀을 더하려면 2를 지정해요. 이틀을 빼려면 -2를 지정해요.
• date_or_time_expr은 날짜, 시간 또는 타임스탬프로 평가되어야 해요.
• 더하려는 날짜, 시간 또는 타임스탬프예요. 예를 들어 2024년 8월 1일에 이틀을 더하려면 '2024-08-01'::DATE를 지정해요.
• 데이터 타입이 TIME이면 date_or_time_part는 일 또는 그보다 큰 단위가 아니라 시간 또는 그보다 작은 단위여야 해요.
• 입력 데이터 타입이 DATE이고 date_or_time_part가 시간 또는 그보다 작은 단위면 입력 값은 거부되지 않고, 처음에 시간, 분, 초와 초의 분수가 모두 0으로 설정된 TIMESTAMP(예: 지정된 날짜의 자정)로 취급돼요.

반환 값

• date_or_time_expr이 시간이면 반환 데이터 타입은 시간이에요.
• date_or_time_expr이 타임스탬프면 반환 데이터 타입은 타임스탬프예요.
• date_or_time_expr이 날짜인 경우:
  • date_or_time_part이 일 또는 그보다 크면(예: month, year) 함수는 DATE 값을 반환해요.
  • date_or_time_part이 일보다 작으면(예: hour, minute, second) 함수는 날짜의 시작 시간으로 00:00:00.000을 사용하는 TIMESTAMP_NTZ 값을 반환해요.

사용상 주의사항

date_or_time_part이 year, quarter 또는 month(또는 그 변형)일 때, 결과 월이 원래 월의 날짜보다 적은 일수를 가진다면 결과의 일(day of the month)이 원래 일과 다를 수 있어요.

예시

TIMEADD와 TIMESTAMPADD 함수는 DATEADD 함수의 별칭이에요. 세 함수 중 어느 것을 사용해도 동일한 결과를 반환하는 예시를 만들 수 있어요.

날짜에 연도를 더해요.

SELECT TO_DATE('2022-05-08') AS original_date,
       DATEADD(year, 2, TO_DATE('2022-05-08')) AS date_plus_two_years;

+---------------+---------------------+
| ORIGINAL_DATE | DATE_PLUS_TWO_YEARS |
|---------------+---------------------|
| 2022-05-08    | 2024-05-08          |
+---------------+---------------------+

날짜에서 연도를 빼요.

SELECT TO_DATE('2022-05-08') AS original_date,
       DATEADD(year, -2, TO_DATE('2022-05-08')) AS date_minus_two_years;

+---------------+----------------------+
| ORIGINAL_DATE | DATE_MINUS_TWO_YEARS |
|---------------+----------------------|
| 2022-05-08    | 2020-05-08           |
+---------------+----------------------+

날짜에 2년과 2시간을 더해요. 먼저 타임스탬프 출력 형식을 설정하고, 테이블을 만들고, 데이터를 삽입해요.

ALTER SESSION SET TIMESTAMP_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF9';
CREATE TABLE datetest (d date);
INSERT INTO datetest VALUES ('2022-04-05');

날짜에 2년과 2시간을 더하는 쿼리를 실행해요.

SELECT d AS original_date,
       DATEADD(year, 2, d) AS date_plus_two_years,
       TO_TIMESTAMP(d) AS original_timestamp,
       DATEADD(hour, 2, d) AS timestamp_plus_two_hours
  FROM datetest;

+---------------+---------------------+-------------------------+--------------------------+
| ORIGINAL_DATE | DATE_PLUS_TWO_YEARS | ORIGINAL_TIMESTAMP      | TIMESTAMP_PLUS_TWO_HOURS |
|---------------+---------------------+-------------------------+--------------------------|
| 2022-04-05    | 2024-04-05          | 2022-04-05 00:00:00.000 | 2022-04-05 02:00:00.000  |
+---------------+---------------------+-------------------------+--------------------------+

결과 월과 같거나 더 많은 일수를 가진 월의 날짜에 한 달을 더해요. 예를 들어 날짜가 1월 31일이면 한 달을 더해도 2월 31일을 반환하면 안 돼요.

SELECT DATEADD(month, 1, '2023-01-31'::DATE) AS date_plus_one_month;

+---------------------+
| DATE_PLUS_ONE_MONTH |
|---------------------|
| 2023-02-28          |
+---------------------+

결과 월보다 적은 일수를 가진 월의 날짜에 한 달을 더해요. 2월 28일에 한 달을 더하면 3월 28일이 반환돼요.

SELECT DATEADD(month, 1, '2023-02-28'::DATE) AS date_plus_one_month;

+---------------------+
| DATE_PLUS_ONE_MONTH |
|---------------------|
| 2023-03-28          |
+---------------------+

시간에 시간을 더해요.

SELECT TO_TIME('05:00:00') AS original_time,
       DATEADD(hour, 3, TO_TIME('05:00:00')) AS time_plus_three_hours;

+---------------+-----------------------+
| ORIGINAL_TIME | TIME_PLUS_THREE_HOURS |
|---------------+-----------------------|
| 05:00:00      | 08:00:00              |
+---------------+-----------------------+

더 알아보기

• Date & time functions
• DATEADD