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 |