Pular para o conteúdo principal
Dispor de um conjunto abrangente de tipos de data e hora é essencial para gerenciar com eficiência dados de séries temporais, e o ClickHouse oferece exatamente isso. De representações compactas de data a timestamps de alta precisão com exatidão de nanossegundos, esses tipos foram projetados para equilibrar a eficiência de armazenamento com os requisitos práticos de diferentes aplicações de séries temporais. Seja trabalhando com dados financeiros históricos, leituras de sensores de IoT ou eventos agendados para o futuro, os tipos de data e hora do ClickHouse oferecem a flexibilidade necessária para lidar com diversos cenários de dados temporais. A variedade de tipos suportados permite otimizar tanto o espaço de armazenamento quanto o desempenho da consulta, mantendo a precisão exigida pelo seu caso de uso.
  • O tipo Date deve ser suficiente na maioria dos casos. Esse tipo requer 2 bytes para armazenar uma data e limita o intervalo a [1970-01-01, 2149-06-06].
  • Date32 cobre um intervalo maior de datas. Ele requer 4 bytes para armazenar uma data e limita o intervalo a [1900-01-01, 2299-12-31]
  • DateTime armazena valores de data e hora com precisão de segundos e um intervalo de [1970-01-01 00:00:00, 2106-02-07 06:28:15] Ele requer 4 bytes por valor.
  • Para os casos em que é necessária mais precisão, DateTime64 pode ser usado. Isso permite armazenar data e hora com precisão de até nanossegundos, com um intervalo de [1900-01-01 00:00:00, 2299-12-31 23:59:59.99999999]. Ele requer 8 bytes por valor.
Vamos criar uma tabela que armazena vários tipos de data:
Podemos usar a função now() para retornar a hora atual e now64() para obtê-la com a precisão especificada pelo primeiro argumento.
Isso preencherá nossas colunas com valores de tempo de acordo com o tipo da coluna:

​
Tipos Time e Time64

Para cenários em que você precisa armazenar valores de horário sem componentes de data, o ClickHouse fornece os tipos Time e Time64, introduzidos na versão 25.6. Eles são úteis para representar agendas recorrentes, padrões diários ou situações em que faz sentido separar os componentes de data e hora.
Para usar Time e Time64, é necessário ativar a configuração: SET enable_time_time64_type = 1;Esses tipos foram introduzidos na versão 25.6
O tipo Time armazena horas, minutos e segundos com precisão de segundos. Internamente, ele é armazenado como um inteiro com sinal de 32 bits e oferece suporte a um intervalo de [-999:59:59, 999:59:59], permitindo valores que excedem 24 horas. Isso pode ser útil ao acompanhar o tempo decorrido ou realizar operações aritméticas que resultem em valores fora de um único dia. Para precisão de subsegundos, Time64 armazena o horário com segundos fracionários configuráveis como um valor Decimal64 com sinal. Ele aceita um parâmetro de precisão (0-9) para definir o número de dígitos fracionários. Valores de precisão comuns são 3 (milissegundos), 6 (microssegundos) e 9 (nanossegundos). Nem Time nem Time64 oferecem suporte a fusos horários — eles representam valores puros de horário, sem contexto regional. Vamos criar uma tabela com colunas de horário:
Podemos inserir valores de tempo usando literais de string ou valores numéricos. Para Time, os valores numéricos são interpretados como segundos desde 00:00:00. Para Time64, os valores numéricos são interpretados como segundos desde 00:00:00, com a parte fracionária interpretada de acordo com a precisão da coluna:
Os valores de tempo podem ser filtrados de forma natural:

​
Fusos horários

Muitos casos de uso também exigem o armazenamento de fusos horários. Podemos definir o fuso horário como o último argumento dos tipos DateTime ou DateTime64:
Após definir um fuso horário em nosso DDL, agora podemos inserir horários usando diferentes fusos horários:
E agora vamos dar uma olhada no que há na nossa tabela:
Na primeira linha, inserimos todos os valores usando o fuso horário America/New_York.
  • dt_1 e dt64_1 são convertidos automaticamente para Europe/Berlin no momento da consulta.
  • dt_2 e dt64_2 não tinham um fuso horário especificado, então usam o fuso horário local do servidor, que, neste caso, é Europe/London.
Na segunda linha, inserimos todos os valores sem especificar um fuso horário, então o fuso horário local do servidor foi usado. Assim como na primeira linha, dt_1 e dt64_1 são convertidos para Europe/Berlin, enquanto dt_2 e dt64_2 usam o fuso horário local do servidor.

​
Funções de data e hora

O ClickHouse também conta com um conjunto de funções que nos permite converter entre diferentes tipos de dados. Por exemplo, podemos usar toDate para converter um valor DateTime no tipo Date:
Podemos usar toDateTime64 para converter DateTime para DateTime64:
E podemos usar toDateTime para converter Date ou DateTime64 novamente em DateTime:
Última modificação em 2 de julho de 2026