날짜 및 시간 데이터 타입¶

간격 리터럴¶

간격 리터럴은 문자열 리터럴에서 기간을 지정하는 식입니다. 다음 구문을 사용하여 간격 리터럴을 지정합니다.

INTERVAL '[ <sign> ] <string>' { <yearMonthQualifier> | <dayTimeQualifier> }

여기서

• sign`은 양수(:code:`+) 또는 음수(-) 기간을 지정하는 선택적 기호입니다.

  기본값: +.

• :samp:`{string}`은 기간을 나타내는 값입니다.

• :samp:`{yearMonthQualifier}`는 :ref:`label-interval_syntax`에 정의된 한정자입니다.

• :samp:`{dayTimeQualifier}`는 :ref:`label-interval_syntax`에 정의된 한정자입니다.

간격 형식¶

특정 형식의 문자열 리터럴은 간격 값을 나타낼 수 있습니다.

연도 및 월 값을 지정하려면 다음 형식을 사용합니다.

'<sign><Y>-<MM>'

여기서

• sign`은 양수(:code:`+) 또는 음수(-) 기간을 지정하는 필수 기호입니다.

  기본값: +.

• :samp:`{Y}`는 연도 수입니다. 허용되는 자릿수(전체 자릿수)는 값의 데이터 타입에 따라 다릅니다.

• :samp:`{MM}`은 월 수를 나타내는 두 자리 숫자로, ``00``~``11``의 범위입니다.

일, 시간, 초, 소수 자리 초의 값을 지정하려면 다음 형식을 사용합니다.

'<sign>[<D>] [<HH24>]:[<MI>]:[<SS>].[<F>]'

여기서

• sign`은 양수(:code:`+) 또는 음수(-) 기간을 지정하는 필수 기호입니다.

  기본값: +.

• :samp:`{D}`는 일 수입니다. 허용되는 자릿수(전체 자릿수)는 값의 데이터 타입에 따라 다릅니다.

  다음 유형의 값에 대해 :samp:`{D}`를 생략합니다.

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL HOUR TO SECOND

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• :samp:`{HH24}`는 시간을 나타내는 두 자리 숫자로, ``00``~``23``의 범위입니다.

  다음 유형의 값에 대해 :samp:`{HH24}`를 생략합니다.

  • INTERVAL DAY

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• :samp:`{MI}`은 분 수를 나타내는 두 자리 숫자로, ``00``~``59``의 범위입니다.

  다음 유형의 값에 대해 :samp:`{MI}`를 생략합니다.

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY

  • INTERVAL HOUR

  • INTERVAL SECOND

• :samp:`{SS}`는 초 수를 나타내는 두 자리 숫자로, ``00``~``59``의 범위입니다.

  다음 유형의 값에 대해 :samp:`{SS}`를 생략합니다.

  • INTERVAL DAY

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY TO MINUTE

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL MINUTE

• :samp:`{F}`는 초를 포함하는 데이터 타입의 소수 자리 초 수입니다. 허용되는 자릿수(전체 자릿수)는 값의 데이터 타입에 따라 다릅니다.

다음 사용법 노트는 간격 형식의 문자열 리터럴에 적용됩니다.

• CAST 또는 TO_CHAR 함수를 사용하여 간격을 텍스트 문자열로 명시적으로 캐스팅하는 경우 문자열 리터럴 표현이 적용됩니다.

• 필드의 선행 0은 전체 자릿수를 지정합니다.

간격 값의 예제¶

다음 테이블은 다양한 간격 값을 나타내는 방법을 보여줍니다. 테이블에 표시된 값은 간격 값에 대해 다음 규칙을 따릅니다.

• 양수 값에서 더하기 기호 :code:`+`는 간격 리터럴 값의 경우 선택 사항이지만 간격 형식 값의 경우 필수입니다.

• 간격 리터럴 값에서 괄호 안의 값은 허용되는 자릿수인 전체 자릿수를 지정합니다. 예를 들어, ``YEAR(3)``은 연도에 3자리 숫자가 허용됨을 지정합니다.

• 간격 형식 값에서 기본 필드(선행 필드)는 선행 0을 포함하지 않습니다. 하위 필드는 고정 자릿수를 사용합니다. 예를 들어, ``+1-08``과 같은 YEAR TO MONTH 값에서 연도 필드에는 선행 0이 없으며 월 필드는 2자리 숫자를 사용합니다.

간격 데이터를 사용하여 산술 수행하기¶

다음 예에서는 간격 데이터를 사용하여 산술을 수행합니다.

날짜에 1년 1개월을 더합니다.

SELECT TO_DATE('2024-01-01') + INTERVAL '1-1' YEAR TO MONTH
  AS date_plus_one_year_one_month;

+------------------------------+
| DATE_PLUS_ONE_YEAR_ONE_MONTH |
|------------------------------|
| 2025-02-01                   |
+------------------------------+

날짜에서 1년 1개월을 뺍니다.

SELECT TO_DATE('2024-01-01') + INTERVAL '-1-1' YEAR TO MONTH
  AS date_plus_one_year_one_month;

+------------------------------+
| DATE_PLUS_ONE_YEAR_ONE_MONTH |
|------------------------------|
| 2022-12-01                   |
+------------------------------+

타임스탬프에 기간을 추가합니다.

SELECT TO_TIMESTAMP('2024-01-01 08:08:08.99') + INTERVAL '1 01:01:01.7878' DAY TO SECOND
  AS date_plus_period_of_time;

+--------------------------+
| DATE_PLUS_PERIOD_OF_TIME |
|--------------------------|
| 2024-01-02 09:09:10.777  |
+--------------------------+

다음 예에서는 SYSTEM$TYPEOF 함수를 사용하여 쿼리에서 두 개의 타임스탬프 값을 뺄 때 INTERVAL DAY TO SECOND 값이 반환됨을 보여줍니다.

SELECT SYSTEM$TYPEOF(TO_TIMESTAMP('2025-10-05 01:02:03') - TO_TIMESTAMP('2025-09-15 11:36:22'))
  AS type;

+------------------------------------+
| TYPE                               |
|------------------------------------|
| INTERVAL DAY(9) TO SECOND(9)[SB16] |
+------------------------------------+

쿼리 결과를 간격 형식으로 보려면 식을 INTERVAL DAY(2) TO SECOND(2) 데이터 타입으로 캐스팅하여 전체 자릿수를 지정한 다음 VARCHAR로 캐스팅합니다.

SELECT (TO_TIMESTAMP('2025-10-05 01:02:03') - TO_TIMESTAMP('2025-09-15 11:36:22'))::INTERVAL DAY(2) TO SECOND(2)::VARCHAR
  AS interval_format_result;

+------------------------+
| INTERVAL_FORMAT_RESULT |
|------------------------|
| +19 13:25:41.00        |
+------------------------+

연도-월 간격 데이터 삽입 및 쿼리하기¶

INTERVAL YEAR TO MONTH 열을 사용하여 공석 후보를 추적하는 테이블을 생성하고 데이터를 삽입합니다.

CREATE OR REPLACE TABLE candidates (
  name_first VARCHAR,
  name_last VARCHAR,
  duration_of_experience INTERVAL YEAR(2) TO MONTH);

INSERT INTO candidates VALUES ('Jane', 'Smith', '14-4');
INSERT INTO candidates VALUES ('Robert', 'Adams', '0-3');
INSERT INTO candidates VALUES ('Mary', 'Jones', '5-11');

duration_of_experience` 열을 데이터 타입으로 캐스팅하지 않고 테이블을 쿼리하는 경우, 출력은 열 값을 각 행의 총 월 수로 표시합니다.

SELECT name_first,
       name_last,
       duration_of_experience AS months_of_experience
  FROM candidates;

+------------+-----------+----------------------+
| NAME_FIRST | NAME_LAST | MONTHS_OF_EXPERIENCE |
|------------+-----------+----------------------|
| Jane       | Smith     |                  172 |
| Robert     | Adams     |                    3 |
| Mary       | Jones     |                   71 |
+------------+-----------+----------------------+

테이블을 쿼리하고 duration_of_experience 열을 VARCHAR 데이터 타입으로 캐스팅하는 경우, 출력은 간격 형식으로 열 값을 표시합니다.

SELECT name_first,
       name_last,
       duration_of_experience::VARCHAR AS duration_of_experience
  FROM candidates;

+------------+-----------+------------------------+
| NAME_FIRST | NAME_LAST | DURATION_OF_EXPERIENCE |
|------------+-----------+------------------------|
| Jane       | Smith     | +14-04                 |
| Robert     | Adams     | +0-03                  |
| Mary       | Jones     | +5-11                  |
+------------+-----------+------------------------+

일-시간 간격 데이터 삽입 및 쿼리하기¶

INTERVAL HOUR TO SECOND 열을 사용하여 다양한 소프트웨어 기능의 시간 제한 기간을 지정하는 테이블을 생성하고 데이터를 삽입합니다.

CREATE OR REPLACE TABLE feature_timeouts (
  feature VARCHAR,
  timeout_duration INTERVAL HOUR(2) TO SECOND(0));

INSERT INTO feature_timeouts VALUES ('Feature1', '00:00:30');
INSERT INTO feature_timeouts VALUES ('Feature2', '00:10:00');
INSERT INTO feature_timeouts VALUES ('Feature3', '01:00:00');

테이블을 쿼리하고 timeout_duration 열을 VARCHAR 데이터 타입으로 캐스팅합니다.

SELECT feature,
       timeout_duration::VARCHAR AS timeout_duration
  FROM feature_timeouts;

+----------+------------------+
| FEATURE  | TIMEOUT_DURATION |
|----------+------------------|
| Feature1 | +0:00:30         |
| Feature2 | +0:10:00         |
| Feature3 | +1:00:00         |
+----------+------------------+

간격 데이터를 테이블에 복사하고 테이블 쿼리하기¶

다음 단계를 완료하여 간격 데이터가 있는 파일을 스테이징한 후 파일을 테이블에 복사합니다.

1. 파일 시스템의 파일에서 다음 내용을 복사합니다.

   Expand

   1,1-2,28 16:15:14.0
   2,-3-2,-54 16:15:14.123
   

   Show lessSee more

   Scroll to top

   이 예제에서는 파일이 interval_values.csv 디렉터리에 /examples/intervals/ 라는 이름으로 있다고 가정해 보겠습니다.

2. 스테이지를 생성합니다.

   CopyExpand

   CREATE STAGE interval_stage;
   

   Show lessSee more

   Scroll to top

3. 내부 스테이지 위치에 파일을 스테이징합니다.

   CopyExpand

   PUT file:///examples/intervals/interval_values.csv @~/interval_stage
     AUTO_COMPRESS=false;
   

   Show lessSee more

   Scroll to top

4. 데이터를 위한 테이블을 생성합니다.

   CopyExpand

   CREATE OR REPLACE TABLE sample_interval_values(
     c1 STRING,
     c2 INTERVAL YEAR(1) TO MONTH,
     c3 INTERVAL DAY(2) TO SECOND(3));
   

   Show lessSee more

   Scroll to top

5. 생성한 테이블에 스테이징된 파일을 로드하려면 COPY INTO <테이블> 명령을 사용합니다.

   CopyExpand

   COPY INTO sample_interval_values FROM @~/interval_stage;
   

   Show lessSee more

   Scroll to top

6. 로드된 데이터를 보려면 테이블을 쿼리하고 VARCHAR 타입으로 캐스팅하여 로드된 데이터를 확인합니다.

   CopyExpand

   SELECT c1,
          c2::VARCHAR AS YEAR_TO_MONTH,
          c3::VARCHAR AS DAY_TO_SECOND,
     FROM sample_interval_values;
   

   Show lessSee more

   Scroll to top
   Expand

   +----+---------------+------------------+
   | C1 | YEAR_TO_MONTH | DAY_TO_SECOND    |
   |----+---------------+------------------|
   | 1  | +1-02         | +28 16:15:14.000 |
   | 2  | -3-02         | -54 16:15:14.123 |
   +----+---------------+------------------+
   

   Show lessSee more

   Scroll to top