Interval 데이터 타입

Interval 데이터 타입

시간·날짜 간격을 나타내는 데이터 타입 계열이에요. INTERVAL 연산자의 결과 타입이에요. 각 간격 타입마다 별도의 데이터 타입이 있어요. 예를 들어 DAY 간격은 IntervalDay 데이터 타입에 대응해요.

출처: 문서

본문

시간·날짜 간격을 나타내는 데이터 타입 계열이에요. INTERVAL 연산자의 결과 타입이에요.

구조:

  • 부호 없는 정수 값으로서의 시간 간격.
  • 간격의 타입.

지원되는 간격 타입:

  • NANOSECOND
  • MICROSECOND
  • MILLISECOND
  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR

각 간격 타입마다 별도의 데이터 타입이 있어요. 예를 들어 DAY 간격은 IntervalDay 데이터 타입에 대응해요.

SELECT toTypeName(INTERVAL 4 DAY)
┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘

사용 시 유의점 (Usage Remarks)

Date와 DateTime 타입 값과의 산술 연산에 Interval 타입 값을 사용할 수 있어요. 예를 들어 현재 시간에 4일을 더할 수 있어요.

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY
┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘

여러 간격을 동시에 사용하는 것도 가능해요.

SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)
┌───current_date_time─┬─plus(current_date_time, plus(toIntervalDay(4), toIntervalHour(3)))─┐
│ 2024-08-08 18:31:39 │                                                2024-08-12 21:31:39 │
└─────────────────────┴────────────────────────────────────────────────────────────────────┘

다른 간격으로 값을 비교할 수도 있어요.

SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);
┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘
SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);
┌─equals(toIntervalMicrosecond(3600000000), toIntervalHour(1))─┐
│                                                            1 │
└──────────────────────────────────────────────────────────────┘

집계 (Aggregation)

Interval 컬럼에 대한 sum, avg, min, max, any는 같은 타입의 간격을 반환해요. sum은 단위 수를 더하고, avg는 그것들을 평균내 결과를 단위의 정수로 반올림해요.

SELECT
    sum(duration) AS total_duration,
    avg(duration) AS avg_duration,
    toTypeName(total_duration)
FROM VALUES('duration IntervalMillisecond',
    toIntervalMillisecond(100), toIntervalMillisecond(200), toIntervalMillisecond(300))
┌─total_duration─┬─avg_duration─┬─toTypeName(total_duration)─┐
│            600 │          200 │ IntervalMillisecond        │
└────────────────┴──────────────┴────────────────────────────┘

다른 단위의 값들은 집계되기 전 공통 단위로 환산돼요. 그래서 분과 초를 더하면 61초가 돼요. Month, Quarter, Year는 더 작은 단위들과 공통 단위가 없어요 — 한 달은 고정된 일 수가 아니기 때문이에요 — 그래서 그것들과 전혀 섞을 수 없어요.

혼합 타입 간격 (Mixed-type Intervals)

여러 시간과 여러 분 같은 혼합 타입의 간격은 INTERVAL 'value' <from_kind> TO <to_kind> 문법으로 만들 수 있어요. 결과는 둘 이상의 간격으로 된 튜플이에요.

지원되는 조합:

문법 문자열 형식 예시
YEAR TO MONTH Y-M INTERVAL '2-6' YEAR TO MONTH
DAY TO HOUR D H INTERVAL '5 12' DAY TO HOUR
DAY TO MINUTE D H:M INTERVAL '5 12:30' DAY TO MINUTE
DAY TO SECOND D H:M:S INTERVAL '5 12:30:45' DAY TO SECOND
HOUR TO MINUTE H:M INTERVAL '1:30' HOUR TO MINUTE
HOUR TO SECOND H:M:S INTERVAL '1:30:45' HOUR TO SECOND
MINUTE TO SECOND M:S INTERVAL '5:30' MINUTE TO SECOND

선두가 아닌 필드는 SQL 표준에 따라 검증돼요: MONTH 0-11, HOUR 0-23, MINUTE 0-59, SECOND 0-59.

SELECT INTERVAL '1:30' HOUR TO MINUTE;
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

선택적인 선두 + 또는 - 부호는 모든 구성 요소에 적용돼요.

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- this is equivalent to:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

더 알아보기 (Learn more)