Função DateDiff

Devolve o número de intervalos de data ou hora entre dois valores de data especificados.

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 cadeia de caracteres da tabela seguinte, que especifica o intervalo de data ou hora.

intervalo (valor de cadeia de caracteres)	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	Segundo

data1, data2 - Os dois valores de data a comparar.

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

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

firstdayofweek: Um parâmetro opcional que especifica o dia em que começa a semana.

valor do primeiro dia da semana	Explicação
0	Utilizar o valor 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 semana inicial de um ano.

valor da primeira semana do ano	Explicação
0	Utilizar o valor do sistema
1	Semana 1 é a semana de 1 de janeiro (padrão)
2	Semana 1 é a primeira semana que contém quatro ou mais dias desse ano
3	Semana 1 é a primeira semana que só contém dias do novo ano

Exemplo:


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