Partilhar via

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 determinado período de tempo 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 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 a partir do qual calcular o deslocamento. Esta não pode ser uma data literal. Deve ser GETGMTDATE ou o resultado de outra função DATEADD.

Comentários

A função DATEADD pode ser usada apenas em comparações de valores literais e apenas no lado direito do operador de comparação.

A função GETGMTDATE retorna a data e 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 de igual (=) porque a representação de tempo interna 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

O exemplo de cláusula WHERE a seguir corresponde a documentos que foram modificados nos últimos cinco dias:

...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())

O exemplo a seguir da cláusula WHERE corresponde a documentos que foram modificados nos últimos dois dias e quatro horas:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

de referência

de comparação de valores literais

Comparações de valores múltiplos (ARRAY)

Conceptual

Full-Text Predicados

Predicados nãoFull-Text