Tipos de dados de data e hora¶

Literais de intervalo¶

Literal de intervalo é uma expressão que especifica uma duração de tempo em um literal de cadeia de caracteres. Use a seguinte sintaxe para especificar um literal de intervalo:

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

Onde:

• sign é um símbolo opcional que especifica uma duração de tempo positiva (+) ou negativa (-).

  Padrão: +.

• string é um valor que representa uma duração de tempo.

• yearMonthQualifier é um qualificador definido em Sintaxe dos tipos de dados de intervalo.

• dayTimeQualifier é um qualificador definido em Sintaxe dos tipos de dados de intervalo.

Formatos de intervalo¶

Literais de cadeia de caracteres em formatos específicos podem representar valores de intervalo.

Para especificar valores de anos e meses, use o seguinte formato:

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

Onde:

• sign é um símbolo obrigatório que especifica uma duração de tempo positiva (+) ou negativa (-).

  Padrão: +.

• Y é o número de anos. O número de dígitos permitido (precisão) depende do tipo de dados do valor.

• MM representa os dois dígitos para o número de meses, de 00 a 11.

Para especificar valores de dias, horas, segundos e segundos fracionários, use o seguinte formato:

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

Onde:

• sign é um símbolo obrigatório que especifica uma duração de tempo positiva (+) ou negativa (-).

  Padrão: +.

• D é o número de dias. O número de dígitos permitido (precisão) depende do tipo de dados do valor.

  Omita D para valores dos seguintes tipos:

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL HOUR TO SECOND

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• HH24 representa os dois dígitos para o número de horas, de 00 a 23.

  Omita HH24 para valores dos seguintes tipos:

  • INTERVAL DAY

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• MI representa os dois dígitos para o número de minutos, de 00 a 59.

  Omita MI para valores dos seguintes tipos:

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY

  • INTERVAL HOUR

  • INTERVAL SECOND

• SS representa os dois dígitos para o número de segundos, de 00 a 59.

  Omita SS para valores dos seguintes tipos:

  • INTERVAL DAY

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY TO MINUTE

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL MINUTE

• F é o número de segundos fracionários para os tipos de dados que incluem segundos. O número de dígitos permitido (precisão) depende do tipo de dados do valor.

As seguintes notas de uso se aplicam a literais de cadeia de caracteres no formato de intervalo:

• A representação do literal de cadeia de caracteres se aplica quando você usa a função CAST ou TO_CHAR para converter intervalos explicitamente em cadeias de caracteres de texto.

• Zeros iniciais em um campo especificam a precisão.

Exemplos de valores de intervalo¶

A tabela a seguir mostra como representar vários valores de intervalo. Os valores mostrados na tabela estão em conformidade com as seguintes regras para valores de intervalo:

• Para valores positivos, o sinal de mais + é opcional para valores de literal de intervalo, mas obrigatório para valores de formato de intervalo.

• Nos valores de literal de intervalo, o valor entre parênteses especifica a precisão, que é o número de dígitos permitido. Por exemplo, YEAR(3) especifica que três dígitos são permitidos no ano.

• Nos valores de formato de intervalo, o campo primário (campo inicial) não inclui zeros iniciais. Os campos subordinados utilizam um número fixo de dígitos. Por exemplo, em um valor YEAR TO MONTH, como +1-08, o campo do ano não tem zeros iniciais e o campo do mês usa dois dígitos.

Operando aritmética com dados de intervalo¶

Os exemplos a seguir operam aritmética com dados de intervalo.

Adicionar um ano e um mês a uma data:

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                   |
+------------------------------+

Subtrair um ano e um mês de uma data:

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                   |
+------------------------------+

Adicionar um período de tempo a um carimbo de data/hora:

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  |
+--------------------------+

O seguinte exemplo usa a função SYSTEM$TYPEOF para mostrar que um valor INTERVAL DAY TO SECOND é retornado quando uma consulta subtrai dois valores de carimbo de data/hora:

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] |
+------------------------------------+

Para visualizar os resultados da consulta no formato de intervalo, você pode converter a expressão no tipo de dados INTERVAL DAY(2) TO SECOND(2) para especificar a precisão e, depois, converter em 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        |
+------------------------+

Inserindo e consultando dados de intervalo de ano-mês¶

Crie uma tabela que rastreie os candidatos às posições abertas com uma coluna INTERVAL YEAR TO MONTH e insira os dados:

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');

Quando você consulta a tabela sem converter a coluna duration_of_experience` em um tipo de dados, a saída mostra os valores da coluna como o número total de meses em cada linha:

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 |
+------------+-----------+----------------------+

Quando você consulta a tabela e converte a coluna duration_of_experience no tipo de dados VARCHAR, a saída mostra os valores da coluna no formato de intervalo:

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                  |
+------------+-----------+------------------------+

Inserindo e consultando dados de intervalo de dia-hora¶

Crie uma tabela que especifique a duração do tempo limite para vários recursos de software com uma coluna INTERVAL HOUR TO SECOND e insira os dados:

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');

Consulte a tabela e converta a coluna timeout_duration no tipo de dados 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         |
+----------+------------------+

Copiando dados de intervalo em uma tabela e consultando a tabela¶

Conclua as etapas a seguir para preparar um arquivo com dados de intervalo e, em seguida, copie o arquivo em uma tabela:

1. Em um arquivo em seu sistema de arquivos, copie o seguinte conteúdo:

   Expand

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

   Show lessSee more

   Scroll to top

   Este exemplo assume que o nome do arquivo é interval_values.csv no diretório /examples/intervals/.

2. Crie uma área de preparação:

   CopyExpand

   CREATE STAGE interval_stage;
   

   Show lessSee more

   Scroll to top

3. No local da área de preparação interna, prepare o arquivo:

   CopyExpand

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

   Show lessSee more

   Scroll to top

4. Crie uma tabela para os dados:

   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. Para carregar o arquivo preparado na tabela que você criou, use o comando COPY INTO <tabela>:

   CopyExpand

   COPY INTO sample_interval_values FROM @~/interval_stage;
   

   Show lessSee more

   Scroll to top

6. Para visualizar os dados carregados, consulte a tabela e converta no tipo 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