sql dateadd: Guia definitivo para dominar a DATEADD no SQL Server

by EquipeConteudo Sistemas escalaveis
Pre

Quando se trata de manipular datas em bancos de dados, a função DATEADD, conhecida no universo SQL como DATEADD, é uma das ferramentas mais úteis e versáteis. Neste guia completo sobre sql dateadd, vamos explorar desde a sintaxe básica até cenários avançados, incluindo exemplos práticos, considerações de desempenho e boas práticas. Se você busca entender como somar ou subtrair unidades de tempo de forma confiável, este artigo oferece tudo o que você precisa para trabalhar com sql dateadd de maneira eficiente e legível.

O que é sql dateadd e por que usar DATEADD

sql dateadd descreve a operação de acrescentar uma determinada quantidade de tempo a uma data ou horário. Em termos simples, a função DATEADD permite “adicionar” (ou subtrair, com números negativos) anos, meses, dias, horas, minutos, segundos e milissegundos a um valor de data. Essa é a base de muitas rotinas de ETL, geração de séries de datas e cálculos de prazos em aplicações empresariais.

O termo sql dateadd aparece com frequência em pesquisas e documentação. No entanto, o uso correto no T-SQL é DATEADD, em maiúsculas, pois é o nome da função nativa do Microsoft SQL Server. Em textos, artigos ou tutoriais, você verá as duas formas — sql dateadd (variação e SEO) e DATEADD (formato técnico). O importante é entender o conceito: somar ou subtrair unidades de tempo a uma data.

Sintaxe da DATEADD (sql dateadd)

A sintaxe da função DATEADD é direta, mas é comum encontrar confusão entre datepart, number e date. A forma geral é:

DATEADD (datepart, number, date)

Onde:

  • datepart indica a unidade de tempo a ser adicionada (por exemplo, year, month, day, hour, minute, second, millisecond).
  • number é a quantidade de unidade a adicionar (posi­tiva para adicionar, negativa para subtrair).
  • date é a data ou o valor datetime para o qual você está aplicando a adição.

Exemplos simples ajudam a entender rapidamente:

SELECT DATEADD(day, 7, GETDATE()) AS ProximaSemana;
SELECT DATEADD(year, -2, '2024-08-15') AS DoisAnosAntes;

Esses exemplos ilustram a ideia central: sql dateadd não modifica o valor original; retorna uma nova data com o ajuste aplicado.

Dateparts disponíveis no DATEADD

Existem várias unidades que você pode usar como datepart em DATEADD. A lista típica em SQL Server inclui:

  • year | y
  • quarter | qq, q
  • month | mm, m
  • day | dd, d
  • week | wk, ww
  • weekday
  • hour | hh
  • minute | mi, n
  • second | ss
  • millisecond | ms

Nota: a forma entre parênteses (p.ex., year ou yy) pode variar conforme a versão do SQL Server ou convenções de código. O essencial é que o datepart seja reconhecido pela engine para que o resultado seja calculado corretamente.

Exemplos práticos com DATEADD (sql dateadd)

Adicionando dias, meses e anos

Vamos ver cenários comuns de adição de tempo usando DATEADD.

-- Adicionar 10 dias à data atual
SELECT GETDATE() AS Hoje, DATEADD(day, 10, GETDATE()) AS DaquiDezDias;
-- Adicionar 3 meses a uma data específica
SELECT CAST('2024-02-15' AS date) AS DataOriginal,
       DATEADD(month, 3, '2024-02-15') AS NovoMes;
-- Adicionar 1 ano
SELECT DATEADD(year, 1, '2023-11-30') AS UmAnoDepois;

Subtração com DATEADD

Para subtrair tempo, use números negativos. Funciona para qualquer datepart.

-- Subtrair 6 horas da data atual
SELECT GETDATE() AS Agora, DATEADD(hour, -6, GETDATE()) AS SeisHorasAntes;
-- Subtrair 15 dias
SELECT DATEADD(day, -15, GETDATE()) AS QuinzeDiasAtras;

Casos especiais com datas específicas

Quando o valor de date é o último dia do mês ou um dia que não existe após o ajuste de data, DATEADD lida com isso de forma previsível. Por exemplo:

-- 31 de janeiro de 2020 + 1 mês -> 29 de fevereiro de 2020 (ano bissexto)
SELECT DATEADD(month, 1, '2020-01-31') AS UmMesDepois;
-- 31 de janeiro de 2019 + 1 mês -> 28 de fevereiro de 2019
SELECT DATEADD(month, 1, '2019-01-31') AS UmMesDepois2019;

Combinando DATEADD com CURRENT_TIMESTAMP

Outra prática comum é combinar DATEADD com funções de data atuais para filtragem ou geração de janelas temporais.

-- Data de hoje mais 30 dias com timestamp atual
SELECT DATEADD(day, 30, CURRENT_TIMESTAMP) AS Proximos30Dias;
-- Subtrair 1 mês da data de hoje
SELECT DATEADD(month, -1, CURRENT_TIMESTAMP) AS MesAtualMenosUm;

DATEADD com diferentes tipos de dados

O DATEADD aceita diversos tipos de data/hora como o terceiro argumento. Os mais comuns são date, datetime, datetime2, smalldatetime e datetimeoffset. A escolha depende do tipo de dado da coluna alvo e do nível de precisão que você precisa.

Trabalhando com DATE, DATETIME, DATETIME2

-- Exemplo com date
SELECT DATEADD(day, 5, CAST('2024-04-01' AS date)) AS NovoDiaDate;

-- Exemplo com datetime
SELECT DATEADD(hour, 3, CAST('2024-04-01 12:00:00' AS datetime)) AS NovoHorarioDatetime;

-- Exemplo com datetime2
SELECT DATEADD(minute, 15, CAST('2024-04-01T12:00:00.0000000' AS datetime2)) AS NovoMinutoDatetime2;

Smaller datetime e precisão

Se você estiver usando smalldatetime, observe que ele tem resolução de minutos. DATEADD funciona naturalmente, mas o resultado pode arredondar para o minuto mais próximo.

SELECT DATEADD(second, 30, CAST('2024-04-01 12:00:00' AS smalldatetime)) AS AdicaoEmSmalldatetime;

Datetimeoffset para fusos horários

Quando trabalhamos com dados de fusos horários, o tipo datetimeoffset pode ser útil. DATEADD funciona nesse tipo preservando o deslocamento.

SELECT DATEADD(hour, 2, CAST('2024-04-01 10:00:00+00:00' AS datetimeoffset)) AS HorasComFuso;

Como DATEADD pode impactar índices e consultas

Uma preocupação comum é como o uso de DATEADD afeta o desempenho de consultas, especialmente quando usado em cláusulas WHERE contra colunas de data. Em geral, aplicar DATEADD diretamente na parte da cláusula de filtro pode tornar a consulta menos sargable se for feito sobre a coluna, ou seja, se você aplicar a função na coluna em vez de comparar com uma expressão constante.

Exemplos para entender:

-- Bom para sargabilidade (quando a expressão usa uma constante à direita)
SELECT *
FROM Pedidos
WHERE OrderDate >= DATEADD(day, -30, GETDATE());
-- Não tão bom (quando DATEADD é aplicado à coluna)
SELECT *
FROM Pedidos
WHERE DATEADD(day, 0, OrderDate) >= GETDATE();

Boas práticas incluem manter a comparação com constantes ou preparar faixas de data já calculadas fora da consulta quando possível, para não bloquear índices. Em geral, planejar as janelas temporais com DATEADD na cláusula de filtro ajuda na performance, mantendo a leitura de índices eficiente.

Erros comuns e como evitá-los

Ao trabalhar com sql dateadd, alguns erros são frequentes. Aqui estão os mais comuns e como corrigi-los:

  • Usar datepart inexistente: verifique se o datepart está entre os suportados pelo seu SGBD (em SQL Server, utilize year, month, day, hour, minute, second, etc.).
  • Objeto date inválido: certifique-se de que o terceiro parâmetro é uma data válida. Datas literais devem estar em formatos reconhecidos pelo servidor, como ‘YYYY-MM-DD’ ou ISO 8601.
  • Uso de números muito grandes: números excessivamente grandes podem levar a resultados inesperados ou overflow. Em geral, mantenha números razoáveis para a unidade desejada.
  • Subtração com números negativos não intencional: verifique a lógica do número para evitar subtrações acidentais.
  • Sem considerar fusos horários: ao lidar com datetimeoffset, revise o fuso para evitar distorções de horário entre ambientes.

Comparação com DATEADD em outras bases de dados

Enquanto o DATEADD é uma função clássica do SQL Server, outras plataformas possuem funções semelhantes com nomes diferentes:

  • MySQL: DATE_ADD ou operações com INTERVAL. Exemplo: SELECT DATE_ADD(NOW(), INTERVAL 7 DAY);
  • PostgreSQL: uso do INTERVAL, com operadores de adição: SELECT NOW() + INTERVAL '7 days';
  • Oracle: funções como ADD_MONTHS para meses, ou INTERVAL DAY TO SECOND para intervalos de tempo.

Mesmo com diferenças na sintaxe, o conceito central permanece: somar ou subtrair tempo de uma data. Entender sql dateadd no SQL Server facilita a transição entre plataformas quando necessário, mantendo uma visão comum sobre como construir janelas temporais confiáveis.

Casos de uso comuns com DATEADD (sql dateadd)

A prática de date arithmetic com DATEADD aparece em diversos cenários. Abaixo estão alguns casos de uso frequentes:

  • Gerar séries de datas para relatórios diários, semanais ou mensais.
  • Calcular vencimentos, prazos e datas de renovação com base em datas de referência.
  • Normalizar horários, convertendo tudo para Greenwich Mean Time (GMT) ou para o fuso desejado usando datetimeoffset.
  • Rotinas de ETL que constrainam ou expandem janelas de dados para processamento incremental.
  • Ajustes de calendário fiscal, com meses que possuem durações específicas para o negócio.

Vamos ver alguns exemplos práticos que ilustram esses cenários:

-- Gerar uma lista de datas para os próximos 12 dias
WITH Datas AS (
  SELECT CAST(GETDATE() AS date) AS DataInicial
  UNION ALL
  SELECT DATEADD(day, 1, DataInicial)
  FROM Datas
  WHERE DataInicial < CAST(GETDATE() AS date) + 11
)
SELECT DataInicial FROM Datas;
-- Calcular data de vencimento 30 dias após a data de emissão
SELECT DataEmissao, DATEADD(day, 30, DataEmissao) AS DataVencimento
FROM Pedidos
WHERE PedidoId = 12345;
-- Ajustar hora de um timestamp para o fim do dia
SELECT DATEADD(day, 1, CAST(GETDATE() AS date)) - CAST(0 AS time) AS FimDoDia;

Boas práticas para uso do sql dateadd

Para garantir clareza, desempenho e facilidade de manutenção, aqui vão algumas recomendações práticas:

  • Use DATEADD em variações que deixam claro o objetivo, por exemplo: DATEADD(day, 7, data), DATEADD(month, -1, data).
  • Preferir datas constantes na cláusula WHERE quando possível para manter índices.
  • Documentar o significado da janela temporal utilizada; isso facilita manutenções futuras.
  • Quando possível, evitar aninhar muitas funções sobre colunas em condições complexas; em vez disso, calcular faixas de data antes da consulta.
  • Testar casos de borda com end-of-month e anos bissextos para evitar surpresas.

FAQ sobre sql dateadd e DATEADD

Abaixo, perguntas frequentes que ajudam a consolidar o entendimento sobre DATEADD e sql dateadd.

DATEADD retorna NULL quando o input é NULL?

Sim. Se qualquer argumento date ou datepart for NULL, o resultado também será NULL. É uma consequência natural do tratamento de nulos em expressões SQL.

Qual a diferença entre DATEADD e ADDDATE?

DATEADD é a função específica do SQL Server (T-SQL). ADDDATE é comum em MySQL. Embora ambas adicionem tempo a uma data, a sintaxe e os dateparts variam conforme a plataforma. Em ambientes que não são SQL Server, use a função correspondente da sua base de dados.

É possível usar DATEADD com horários com fuso?

Sim, especialmente com datetimeoffset. DATEADD funciona preservando o fuso horário quando você opera com datetimeoffset, o que é essencial para aplicações globais que precisam de consistência temporal.

Conclusão

O sql dateadd — ou, de forma mais técnica, a função DATEADD — é uma ferramenta indispensável para qualquer profissional que trabalha com dados temporais no SQL Server. Entender a sintaxe, conhecer os dateparts disponíveis, explorar casos práticos com diferentes tipos de dados e aplicar boas práticas de desempenho transforma o uso dessa função em um diferencial de qualidade e eficiência nas suas consultas. Ao dominar sql dateadd, você passa a criar consultas mais legíveis, manterá janelas temporais consistentes e ganhará agilidade na implementação de relatórios, rotinas de ETL e lógica de negócio baseada em datas.

Resumo rápido: comandos-chave de sql dateadd

  • DATEADD(day, 7, GETDATE()) — adiciona 7 dias à data atual;
  • DATEADD(month, -2, ‘2024-06-15’) — subtrai 2 meses da data fornecida;
  • DATEADD(year, 1, ‘2023-12-31’) — avança para o próximo ano mantendo o dia/meses disponíveis;
  • DATEADD(hour, 5, GETDATE()) — adiciona 5 horas ao timestamp atual;
  • DATEADD(minute, -45, CURRENT_TIMESTAMP) — subtrai 45 minutos;
  • DATEADD(millisecond, 500, ‘2024-04-01 12:00:00’) — adiciona meio segundo;
  • DATEADD(day, 0, OrderDate) — manter a data original (exemplos simples de verificação).

Com este guia, você está pronto para aplicar DATEADD com confiança em seus projetos de dados. Explore diferentes cenários, documente suas escolhas e aproveite ao máximo o poder que DATEADD oferece para manipular temporalidades com precisão e eficiência.