DATEADD (Transact-SQL)
Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric
Essa função adiciona um número (um inteiro com sinal) a um datepart de uma data de entrada e retorna um valor de data/hora modificado. Por exemplo, você pode usar essa função para encontrar a data que esteja a 7 mil minutos a partir de hoje: número = 7000, datepart = minuto, data = hoje.
Confira Funções e tipos de dados de data e hora (Transact-SQL) para ter uma visão geral de todas as funções e tipos de dados de data e hora do Transact-SQL.
Convenções de sintaxe de Transact-SQL
Sintaxe
DATEADD (datepart , number , date )
Observação
Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.
Argumentos
datepart
A parte de date à qual o DATEADD
adiciona um númerointeiro. Esta tabela lista todos os argumentos datepart válidos.
Observação
DATEADD
não aceita os equivalentes de variável definidos pelo usuário para os argumentos datepart.
datepart | Abreviações |
---|---|
year | yy, yyyy |
quarter | qq, q |
month | mm, m |
dayofyear | dy, y |
day | dd, d |
week | wk, ww |
weekday | dw, w |
hour | hh |
minute | mi, n |
second | ss, s |
millisecond | ms |
microsecond | mcs |
nanosecond | ns |
number
Uma expressão que pode ser resolvida para um int que DATEADD
adiciona a um datepart de date. DATEADD
aceita valores de variável definidos pelo usuário para número. DATEADD
trunca um valor específico de número que tem uma fração decimal. Não arrendondará o valor número nessa situação.
date
Uma expressão que pode resolver um dos seguintes valores:
- date
- datetime
- datetimeoffset
- datetime2
- smalldatetime
- time
Para date, DATEADD
aceitará uma variável de expressão de coluna, de expressão, de literal de cadeia de caracteres ou definida pelo usuário. Um valor literal de cadeia de caracteres deve resolver um datetime. Para evitar ambiguidade, use anos de quatro dígitos. Consulte Configurar a opção two digit year cutoff de configuração de servidor para obter informações sobre anos de dois dígitos.
Tipos de retorno
O tipo de dados do valor retornado para esse método é dinâmico. O tipo de retorno depende do argumento fornecido para date
. Se o valor para date
for uma data literal de cadeia de caracteres, DATEADD
retornará um valor datetime. Se outro tipo de dados de entrada válido for fornecido para date
, DATEADD
retornará o mesmo tipo de dados. DATEADD
gerará um erro se a escala de segundos do literal de cadeia de caracteres exceder três casas decimais (,nnn) ou se o literal de cadeia de caracteres contiver a parte de deslocamento de fuso horário.
Valor retornado
Argumento datepart
dayofyear, day e weekday retornam o mesmo valor.
Cada datepart retorna o mesmo valor das abreviações dela.
Se as seguintes condições forem verdadeiras:
- datepart será mês
- o mês da data terá mais dias do que o mês retornado
- o dia da data não existirá no mês retornado
Em seguida, DATEADD
retornará o último dia do mês de retorno. Por exemplo, setembro tem 30 (trinta) dias; portanto, essas instruções retornam “2006-09-30 00:00:00.000”:
SELECT DATEADD(month, 1, '20060830');
SELECT DATEADD(month, 1, '2006-08-31');
Argumento number
O argumento number não pode exceder o intervalo de int. Nas instruções a seguir, o argumento number excede o intervalo de int em 1. Essas duas instruções retornam a seguinte mensagem de erro: Msg 8115, Level 16, State 2, Line 1. Arithmetic overflow error converting expression to data type int.
SELECT DATEADD(year,2147483648, '20060731');
SELECT DATEADD(year,-2147483649, '20060731');
Argumento date
DATEADD
não aceitará um argumento date incrementado em um valor fora do intervalo de seu tipo de dados. Nas instruções a seguir, o valor number adicionado ao valor de date excede o intervalo do tipo de dados date. DATEADD
retorna a seguinte mensagem de erro: Msg 517, Level 16, State 1, Line 1 Adding a value to a 'datetime' column caused overflow.
SELECT DATEADD(year,2147483647, '20060731');
SELECT DATEADD(year,-2147483647, '20060731');
Retorna valores de uma data smalldatetime e uma parte de data de segundo ou frações de segundo
A segunda parte de um valor smalldatetime é sempre 00. Para um valor smalldatetimedate, aplica-se o seguinte:
- Para um datepart de segundo e um valor de número entre -30 e +29,
DATEADD
não fará nenhuma alteração. - Para um datepart de segundo e um valor de número menor que -30 ou maior que +29,
DATEADD
executa sua adição a partir do minuto um. - Para um datepart de milissegundos e um valor de número entre -30001 e +29998,
DATEADD
não faça nenhuma alteração. - Para um datepart de milissegundo e um valor de número menor que -30001 ou maior que +29998,
DATEADD
executa sua adição a partir do minuto um.
Comentários
Use DATEADD
nas seguintes cláusulas:
- GROUP BY
- HAVING
- ORDER BY
- SELECT <list>
- WHERE
Precisão de segundos fracionários
DATEADD
não permite a adição de um datepart de microssegundo ou nanossegundo para tipos de dados de datesmalldatetime, date, e datetime.
Os milissegundos têm uma escala de 3 (0,123). Os microssegundos têm uma escala de 6 (0,123456). Os nanossegundos têm uma escala de 9 (0,123456789). Os tipos de dados time, datetime2 e datetimeoffset têm uma escala máxima de 7 (.1234567). Para um datepart de nanossegundo, o número deve ser 100 antes do aumento dos segundos fracionários de date. Um número entre 1 e 49 será arredondado para baixo para 0, e um número de 50 a 99 é arrendondado para cima até 100.
Estas instruções adicionam uma datepart de milissegundo, microssegundo ou nanossegundo.
DECLARE @datetime2 datetime2 = '2007-01-01 13:10:10.1111111';
SELECT '1 millisecond', DATEADD(millisecond,1,@datetime2)
UNION ALL
SELECT '2 milliseconds', DATEADD(millisecond,2,@datetime2)
UNION ALL
SELECT '1 microsecond', DATEADD(microsecond,1,@datetime2)
UNION ALL
SELECT '2 microseconds', DATEADD(microsecond,2,@datetime2)
UNION ALL
SELECT '49 nanoseconds', DATEADD(nanosecond,49,@datetime2)
UNION ALL
SELECT '50 nanoseconds', DATEADD(nanosecond,50,@datetime2)
UNION ALL
SELECT '150 nanoseconds', DATEADD(nanosecond,150,@datetime2);
Este é o conjunto de resultados.
1 millisecond 2007-01-01 13:10:10.1121111
2 milliseconds 2007-01-01 13:10:10.1131111
1 microsecond 2007-01-01 13:10:10.1111121
2 microseconds 2007-01-01 13:10:10.1111131
49 nanoseconds 2007-01-01 13:10:10.1111111
50 nanoseconds 2007-01-01 13:10:10.1111112
150 nanoseconds 2007-01-01 13:10:10.1111113
Deslocamento de fuso horário
DATEADD
não permite acréscimo ao deslocamento de fuso horário.
Exemplos
R. Incrementar datepart em um intervalo de 1
Cada uma destas instruções incrementa datepart em um intervalo de 1:
DECLARE @datetime2 datetime2 = '2007-01-01 13:10:10.1111111';
SELECT 'year', DATEADD(year,1,@datetime2)
UNION ALL
SELECT 'quarter',DATEADD(quarter,1,@datetime2)
UNION ALL
SELECT 'month',DATEADD(month,1,@datetime2)
UNION ALL
SELECT 'dayofyear',DATEADD(dayofyear,1,@datetime2)
UNION ALL
SELECT 'day',DATEADD(day,1,@datetime2)
UNION ALL
SELECT 'week',DATEADD(week,1,@datetime2)
UNION ALL
SELECT 'weekday',DATEADD(weekday,1,@datetime2)
UNION ALL
SELECT 'hour',DATEADD(hour,1,@datetime2)
UNION ALL
SELECT 'minute',DATEADD(minute,1,@datetime2)
UNION ALL
SELECT 'second',DATEADD(second,1,@datetime2)
UNION ALL
SELECT 'millisecond',DATEADD(millisecond,1,@datetime2)
UNION ALL
SELECT 'microsecond',DATEADD(microsecond,1,@datetime2)
UNION ALL
SELECT 'nanosecond',DATEADD(nanosecond,1,@datetime2);
Este é o conjunto de resultados.
Year 2008-01-01 13:10:10.1111111
quarter 2007-04-01 13:10:10.1111111
month 2007-02-01 13:10:10.1111111
dayofyear 2007-01-02 13:10:10.1111111
day 2007-01-02 13:10:10.1111111
week 2007-01-08 13:10:10.1111111
weekday 2007-01-02 13:10:10.1111111
hour 2007-01-01 14:10:10.1111111
minute 2007-01-01 13:11:10.1111111
second 2007-01-01 13:10:11.1111111
millisecond 2007-01-01 13:10:10.1121111
microsecond 2007-01-01 13:10:10.1111121
nanosecond 2007-01-01 13:10:10.1111111
B. Incrementar mais de um nível de datepart em uma instrução
Cada uma destas instruções incrementa datepart em um número grande o suficiente para também incrementar a próxima datepart mais alta de date:
DECLARE @datetime2 datetime2;
SET @datetime2 = '2007-01-01 01:01:01.1111111';
--Statement Result
-------------------------------------------------------------------
SELECT DATEADD(quarter,4,@datetime2); --2008-01-01 01:01:01.1111111
SELECT DATEADD(month,13,@datetime2); --2008-02-01 01:01:01.1111111
SELECT DATEADD(dayofyear,365,@datetime2); --2008-01-01 01:01:01.1111111
SELECT DATEADD(day,365,@datetime2); --2008-01-01 01:01:01.1111111
SELECT DATEADD(week,5,@datetime2); --2007-02-05 01:01:01.1111111
SELECT DATEADD(weekday,31,@datetime2); --2007-02-01 01:01:01.1111111
SELECT DATEADD(hour,23,@datetime2); --2007-01-02 00:01:01.1111111
SELECT DATEADD(minute,59,@datetime2); --2007-01-01 02:00:01.1111111
SELECT DATEADD(second,59,@datetime2); --2007-01-01 01:02:00.1111111
SELECT DATEADD(millisecond,1,@datetime2); --2007-01-01 01:01:01.1121111
C. Usar expressões como argumentos para os parâmetros number e date
Estes exemplos usam diferentes tipos de expressões como argumentos para os parâmetros number e date. Os exemplos usam o banco de dados AdventureWorks.
Especificar uma coluna como data
Este exemplo adiciona 2
(dois) dias a cada valor na coluna OrderDate
para derivar uma nova coluna chamada PromisedShipDate
:
SELECT SalesOrderID
,OrderDate
,DATEADD(day,2,OrderDate) AS PromisedShipDate
FROM Sales.SalesOrderHeader;
Um conjunto de resultados parcial:
SalesOrderID OrderDate PromisedShipDate
------------ ----------------------- -----------------------
43659 2005-07-01 00:00:00.000 2005-07-03 00:00:00.000
43660 2005-07-01 00:00:00.000 2005-07-03 00:00:00.000
43661 2005-07-01 00:00:00.000 2005-07-03 00:00:00.000
...
43702 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43703 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43704 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43705 2005-07-02 00:00:00.000 2005-07-04 00:00:00.000
43706 2005-07-03 00:00:00.000 2005-07-05 00:00:00.000
...
43711 2005-07-04 00:00:00.000 2005-07-06 00:00:00.000
43712 2005-07-04 00:00:00.000 2005-07-06 00:00:00.000
...
43740 2005-07-11 00:00:00.000 2005-07-13 00:00:00.000
43741 2005-07-12 00:00:00.000 2005-07-14 00:00:00.000
Especificar variáveis definidas pelo usuário como número e data
Este exemplo especifica variáveis definidas pelo usuário como argumentos para número e data:
DECLARE @days INT = 365,
@datetime DATETIME = '2000-01-01 01:01:01.111'; /* 2000 was a leap year */;
SELECT DATEADD(day, @days, @datetime);
Este é o conjunto de resultados.
-----------------------
2000-12-31 01:01:01.110
(1 row(s) affected)
Especificar a função do sistema escalar como data
Este exemplo especifica SYSDATETIME
para data. O valor exato retornado depende do dia e da hora da execução da instrução:
SELECT DATEADD(month, 1, SYSDATETIME());
Este é o conjunto de resultados.
---------------------------
2013-02-06 14:29:59.6727944
(1 row(s) affected)
Especificar subconsultas e funções escalares como número e data
Este exemplo usa subconsultas escalares, MAX(ModifiedDate)
, como argumentos para número e data. (SELECT TOP 1 BusinessEntityID FROM Person.Person)
funciona como um argumento artificial do parâmetro de número que mostra como selecionar um argumento number em uma lista de valores.
SELECT DATEADD(month,(SELECT TOP 1 BusinessEntityID FROM Person.Person),
(SELECT MAX(ModifiedDate) FROM Person.Person));
Especificar expressões numéricas e funções do sistema escalares como número e data
Este exemplo usa uma expressão numérica ((10/2))
, operadores unários (-
), um operador aritmético (/
) e funções do sistema escalares (SYSDATETIME
) como argumentos para number e date.
SELECT DATEADD(month,-(10/2), SYSDATETIME());
Especificar funções de classificação como número
Este exemplo usa uma função de classificação como um argumento para number.
SELECT p.FirstName, p.LastName
,DATEADD(day,ROW_NUMBER() OVER (ORDER BY
a.PostalCode),SYSDATETIME()) AS 'Row Number'
FROM Sales.SalesPerson AS s
INNER JOIN Person.Person AS p
ON s.BusinessEntityID = p.BusinessEntityID
INNER JOIN Person.Address AS a
ON a.AddressID = p.BusinessEntityID
WHERE TerritoryID IS NOT NULL
AND SalesYTD <> 0;
Especificar uma função de janela de agregação como número
Este exemplo usa uma função de janela de agregação como um argumento para number.
SELECT SalesOrderID, ProductID, OrderQty
,DATEADD(day,SUM(OrderQty)
OVER(PARTITION BY SalesOrderID),SYSDATETIME()) AS 'Total'
FROM Sales.SalesOrderDetail
WHERE SalesOrderID IN(43659,43664);
GO
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de