Função DATEADD
A função DATEADD executa cálculos de data e hora para propriedades correspondentes que têm tipos de data. Use a função DATEADD para obter datas e horas em uma quantidade especificada de tempo antes do presente.
Sintaxe
DATEADD (DateTimeUnits, OffsetValue, DateTime)
Argumentos
DateTimeUnits
Especifica as unidades do parâmetro DateTime : YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE ou SECOND. Esse valor diferencia maiúsculas de minúsculas e as aspas não são necessárias em torno do parâmetro .
OffsetValue
Especifica o deslocamento de tempo, nas unidades especificadas pelo parâmetro DateTimeUnits . OffsetValue deve ser um inteiro negativo. Não há suporte para valores positivos.
DateTime
Especifica um carimbo de data/hora do qual calcular o deslocamento. Isso não pode ser um literal de data. Ele deve ser GETGMTDATE ou o resultado de outra função DATEADD.
Comentários
A função DATEADD só pode ser usada em comparações de valor literal e somente no lado direito do operador de comparação.
A função GETGMTDATE retorna a data e a hora atuais em Greenwich Mean Time (GMT). Lembre-se de que esse valor pode não ser o mesmo que a hora local do computador.
Não use o operador de comparação igual a (=) porque a representação de tempo interno pode produzir erros de arredondamento que resultam em resultados de correspondência inesperados.
Você pode usar várias funções DATEADD para combinar unidades de deslocamento.
Exemplos
A seguinte cláusula WHERE de exemplo corresponde aos documentos que foram modificados nos últimos cinco dias:
...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())
A seguinte cláusula WHERE de exemplo corresponde a documentos que foram modificados nos últimos dois dias e quatro horas:
...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))
Tópicos relacionados
-
Referência
-
Conceitual