> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 인터벌 특수 데이터 타입에 대한 문서

# 인터벌

시간 및 날짜 인터벌을 나타내는 데이터 타입 계열입니다. [INTERVAL](/ko/reference/operators/index#interval) 연산자의 결과 타입이기도 합니다.

구조:

* 부호 없는 정수 값으로 표현되는 시간 인터벌
* 인터벌의 타입

지원되는 인터벌 타입:

* `NANOSECOND`
* `MICROSECOND`
* `MILLISECOND`
* `SECOND`
* `MINUTE`
* `HOUR`
* `DAY`
* `WEEK`
* `MONTH`
* `QUARTER`
* `YEAR`

각 인터벌 타입에는 별도의 데이터 타입이 있습니다. 예를 들어 `DAY` 인터벌은 `IntervalDay` 데이터 타입에 해당합니다:

```sql theme={null}
SELECT toTypeName(INTERVAL 4 DAY)
```

```text theme={null}
┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘
```

<h2 id="usage-remarks">
  사용 시 유의사항
</h2>

`인터벌` 타입 값은 [Date](/ko/reference/data-types/date) 및 [DateTime](/ko/reference/data-types/datetime) 타입 값과 함께 산술 연산에 사용할 수 있습니다. 예를 들어, 현재 시간에 4일을 더할 수 있습니다:

```sql theme={null}
SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY
```

```text theme={null}
┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘
```

또한 여러 인터벌을 동시에 사용할 수 있습니다:

```sql theme={null}
SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)
```

```text theme={null}
┌───current_date_time─┬─plus(current_date_time, plus(toIntervalDay(4), toIntervalHour(3)))─┐
│ 2024-08-08 18:31:39 │                                                2024-08-12 21:31:39 │
└─────────────────────┴────────────────────────────────────────────────────────────────────┘
```

서로 다른 인터벌의 값을 비교하려면:

```sql theme={null}
SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);
```

```text theme={null}
┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘
```

```sql theme={null}
SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);
```

```text theme={null}
┌─equals(toIntervalMicrosecond(3600000000), toIntervalHour(1))─┐
│                                                            1 │
└──────────────────────────────────────────────────────────────┘
```

<h2 id="aggregation">
  집계
</h2>

`Interval` 컬럼에 `sum`, `avg`, `min`, `max`, `any`를 적용하면 동일한 타입의 인터벌이 반환됩니다.
`sum`은 단위 수를 합산하고, `avg`는 단위 수의 평균을 구한 뒤 결과를 정수 단위로
반올림합니다:

```sql theme={null}
SELECT
    sum(duration) AS total_duration,
    avg(duration) AS avg_duration,
    toTypeName(total_duration)
FROM VALUES('duration IntervalMillisecond',
    toIntervalMillisecond(100), toIntervalMillisecond(200), toIntervalMillisecond(300))
```

```text theme={null}
┌─total_duration─┬─avg_duration─┬─toTypeName(total_duration)─┐
│            600 │          200 │ IntervalMillisecond        │
└────────────────┴──────────────┴────────────────────────────┘
```

서로 다른 단위의 값은 집계되기 전에 공통 단위로 변환됩니다. 따라서
1분과 1초를 합하면 61초가 됩니다. `Month`, `Quarter`, `Year`는 더 작은 단위와
공통 단위가 없으므로(한 달의 일수는 고정되어 있지 않음) 더 작은 단위와는
전혀 혼합할 수 없습니다.

<h2 id="mixed-type-intervals">
  혼합형 인터벌
</h2>

혼합형 인터벌(예: 여러 시간과 여러 분으로 이루어진 인터벌)은 `INTERVAL 'value' <from_kind> TO <to_kind>` 구문을 사용해 만들 수 있습니다.
결과는 2개 이상의 인터벌로 구성된 튜플입니다.

지원되는 조합은 다음과 같습니다.

| 구문 | 문자열 포맷 | 예시 |
| - | - | - |
| `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.

```sql theme={null}
SELECT INTERVAL '1:30' HOUR TO MINUTE;
```

```text theme={null}
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘
```

앞에 올 수 있는 선택적 `+` 또는 `-` 기호는 모든 구성 요소에 적용됩니다:

```sql theme={null}
SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- 위 구문은 다음과 동일합니다:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;
```

```text theme={null}
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘
```

<h2 id="see-also">
  관련 항목
</h2>

* [INTERVAL](/ko/reference/operators/index#interval) 연산자
* [toInterval](/ko/reference/functions/regular-functions/type-conversion-functions#toIntervalYear) 변환 함수
* [avg](/ko/reference/functions/aggregate-functions/avg) 집계 함수
* [sum](/ko/reference/functions/aggregate-functions/sum) 집계 함수