Ir para o conteúdo

Função de Banco de Dados Mvsql - DateAdd()

Resumo

Adiciona ou subtrai uma quantidade dada da parte da data especificada para uma expressão date ou datetime.

Sintaxe

DATEADD(<datepart>, <quantity>, <datetime>)

Parâmetros

Dataparte

Parte da data Aliases Suporte ao fornecedor
year yy, yyyy Todos os fornecedores de RDBMS.
quarter qq, q SQL Server e SQLite
month mm, m Todos os fornecedores de RDBMS.
dayofyear dy, y SQL Server e SQLite
day dd, d Todos os fornecedores de RDBMS.
week wk, ww SQL Server e SQLite
weekday dw, w SQL Server e SQLite
hour hh Todos os fornecedores de RDBMS.
minute mi, n Todos os fornecedores de RDBMS.
second ss, s Todos os fornecedores de RDBMS.

A parte da data não deve ser citada.

A parte da data não diferencia maiúsculas de minúsculas.

Quantidade

Coluna ou expressão do tipo int.

Data e Hora

Coluna ou expressão do tipo datetime ou date. Algumas partes de data esperam um datetime.

Devoluções

Retorna uma data e hora ou data.

Observações

Cada fornecedor de banco de dados pode lidar com limites de data de forma diferente. Por exemplo, o SQL Server calcula semanas usando domingo como o início da semana. O SQLite, por outro lado, usa segunda-feira.

Ao adicionar meses a uma data, o SQLite irá "normalizar" a data. Adicionar 1 mês a 2001-03-31 resultados em 2001-05-01. No SQL Server, adicionar 1 mês a 2001-03-31 retorna 2001-04-30. Isso também afeta trimestres. O SQLite não oferece suporte nativo a trimestres. App Builder polipreenche o quarter parte da data usando intervalos de 3 meses.

Exemplos

Observe que esses exemplos pressupõem o SQL Server.

Expressão Retorna
DATEADD(year, 1, TIMESTAMP('2005-12-31 23:59:59.9999999')) 2006-12-31 23:59:59.9999999
DATEADD(month, 1, TIMESTAMP('2005-12-31 23:59:59.9999999')) 2006-01-31 23:59:59.9999999