Adiciona ou encontra a diferença nos valores de data/hora.

Descrição

A função DateAdd adiciona os Dias, Meses, Trimestres ou Anos a um valor de data/hora. O resultado é um novo valor de data/hora.

A função DateDiff retorna a diferença entre dois valores de data/hora, em Dias, Meses, Trimestres ou Anos. O resultado é um número.

Por padrão, ambas as funções usam Dias como unidades.

Consulte também Trabalhar com datas e horas para obter mais informações.

Sintaxe

DateAdd( DateTime, Adição [, Unidades ] )

  • DateTime - obrigatório. Valor de data/hora no qual operar.
  • Adição - obrigatório. O número a adicionar a DateTime, em Unidades.
  • Unidades - opcional. Dias, Meses, Trimestres ou Anos. Se não especificado, Dias serão usados.

DateDiff( StartDateTime, EndDateTime [, Unidades ])

  • StartDateTime - obrigatório. Valor de data/hora de início.
  • EndDateTime - obrigatório. Valor de data/hora de término.
  • Unidades - opcional. Dias, Meses, Trimestres ou Anos. Se não especificado, Dias serão usados.

Exemplos

Se hoje fosse 15 de julho de 2013:

  • DateAdd(Now(), 3) retornaria 18/7/2013.
  • DateAdd(Today(), 1, Days) e DateAdd(Today(), 1) retornariam 16/7/2013.
  • DateAdd(Today(), 1, Months) retornaria 15/8/2013.
  • DateDiff(Now(), DateValue("1/1/2014")) e DateDiff(Now(), DateValue("1/1/2014"), Days) retornariam 170 dias.
  • DateDiff(Now(), DateValue("1/1/2014"), Months) retornaria 6 meses.