Como usar a função vba dateadd?

A função VBA DATEADD está listada na categoria de data e hora das funções VBA. Quando você o usa no código VBA, ele retorna uma data ou hora com um intervalo adicionado . Em termos simples, pode adicionar segundos, minutos, horas, dias, meses ou anos ao valor de data ou hora e retornar esta nova data e hora no resultado.

Sintaxe

Dateadd(Intervalo, Número, Data)

Argumentos

• Intervalo : uma string para especificar o intervalo.
  • “D” – Dias
  • “H” – Horas
  • “N” – Minutos
  • “M” – Mês
  • “Q” – Trimestres (de um ano)
  • “S” – Segundos
  • “ww” – Semanas
  • “aaaa” – Anos
• Número : o número de intervalos a serem adicionados à data.
• Data : A data em que você deseja adicionar o número específico de intervalos.

Exemplo

Para entender de forma prática como usar a função VBA DATEADD, você precisa seguir o exemplo abaixo, onde escrevemos um código VBA usando-a:

 Sub example_DATE() Range("B1") = DateAdd("YYYY", 2, Range("A1")) End Sub

No exemplo acima, usamos a função DATEADD para adicionar três anos à data que temos na célula A1.

Bem, a data que temos na célula A1 é 13 de novembro de 2017, e na função usamos o intervalo “AAAA” para mencionar que queremos adicionar um ano a isso, e então especificamos 2 como anos.

Com isso, ele retornou em 13 de novembro de 2019, data exata após os 3 anos.

Comentários

• Se o valor especificado for diferente de uma data ou uma data que não possa ser reconhecida como data, o VBA retornará o erro de tempo de execução 13.