Sumário

# 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