Função DATEADD

A função DATEADD executa cálculos de data e hora para propriedades correspondentes com tipos de data. Use a função DATEADD para obter datas e horas em um período especificado antes do presente.

Sintaxe

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Argumentos

DateTimeUnits

Especifica as unidades do parâmetro DateTime: ANO, TRIMESTRE, MÊS, SEMANA, DIA, HORA, MINUTO ou SEGUNDO. Esse valor diferencia maiúsculas de minúsculas e 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. Deve ser GETGMTDATE ou o resultado de outra função DATEADD.

Observações

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 seu computador.

Não use o operador de comparação igual (=) 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 cláusula WHERE de exemplo a seguir 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

de referência de

de comparação de valor literal

comparações de matriz (multivalidade)

Conceitual

predicados Full-Text

predicados nãoFull-Text