Compartilhar via


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()))

Referência

Comparação de valor literal

Comparações com vários valores (ARRAY)

Conceitual

Predicados de texto completo

Predicados de texto não completo