Função DateDiff

Retorna o número de intervalos de data/hora entre dois valores de data específicos.

Sintaxe:


DateDiff (interval As String, date1 As Date, date2 As Date [, firstDayOfWeek As Integer [, firstWeekOfYear As Integer]]) As Double

Valor de retorno:

Um número.

Parâmetros:

intervalo - Uma expressão de string da tabela a seguir, especificando a data ou intervalo de tempo.

intervalo (valor da string)	Explicação
yyyy	Ano
q	Trimestre
m	Mês
y	Dia do ano
w	Dia da semana
ww	Semana do ano
d	Dia
h	Hora
n	Minuto
s	Segundos

data1, data2 - Os dois valores de data a serem comparados.

Literais de data permitem especificar variáveis de data inequívocas que são independentes do idioma atual. Os literais são colocados entre cerquilhas #. Os formatos possíveis são:

#yyyy-mm-dd#
#mm/dd/yyyy#

firstdayofweek - Um parâmetro opcional que especifica o primeiro dia da semana.

Valor firstdayofweek	Explicação
0	Use o valor padrão do sistema
1	Domingo (padrão)
2	Segunda-feira
3	Terça-feira
4	Quarta-feira
5	Quinta-feira
6	Sexta-feira
7	Sábado

firstweekofyear - Um parâmetro opcional que especifica a primeira semana de um ano.

Valor firstweekofyear	Explicação
0	Use o valor padrão do sistema
1	A semana 1 é a semana com 1ro de janeiro (padrão)
2	A semana 1 é a primeira semana que contém quatro ou mais dias desse ano
3	A semana 1 é a primeira semana que contém somente dias do ano novo

Exemplo:


Sub example_datediff
    MsgBox DateDiff("d", #1/1/2005#, #2005-12-31#)
End Sub