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 |