Ir para o conteúdo

Função de Banco de Dados mvSQL - DATEADD()

Resumo

Adiciona ou subtrai uma determinada quantidade da parte da data especificada a uma expressão data ou datahora.

Sintaxe

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

Parâmetros

Parte da Data

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 Hora

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

Devoluções

Retorna uma datahora ou data.

Observações

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

Ao adicionar meses a uma data, o SQLite irá “normalizar” a data. Adicionando 1 mês a 2001-03-31 resulta em 2001-05-01. No SQL Server, adicionando 1 mês a 2001-03-31 retorna 2001-04-30. Isso também afeta os trimestres. SQLite não oferece suporte nativo a trimestres. Polyfills de Vinyl quarter parte da data usando intervalos de 3 meses.

Exemplos

Observe que esses exemplos pressupõem o SQL Server.

Expressão Devoluções
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