IBM Lotus Symphony


Função DateDiff [Tempo de Execução]

Retorna o número de intervalos de datas entre dois valores de data especificados.

Sintaxe:

DateDiff (Add, Date1, Date2 [, Week_start [, Year_start]])

Valores de Retorno:

Um número.

Parâmetros:

Add - Uma expressão de sequência da tabela a seguir, que especifica o intervalo de data.

Tabela 1. Explicação sobre Incluir valores de parâmetros
Add (valor de sequência) 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

Date1, Date2 - Os dois valores de data a serem comparados.

Week_start - Um parâmetro opcional que especifica o primeiro dia de uma semana.

Tabela 2. Explicação sobre valores Week_start
Valor Week_start Explicação
0 Usar 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

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

Tabela 3. Explicação sobre valores Year_start
Valor Year_start Explicação
0 Usar valor-padrão do sistema
1 Semana 1 é a semana com 1º de janeiro (padrão)
2 Semana 1 é a primeira semana contendo quatro ou mais dias desse ano
3 Semana 1 é a primeira semana contendo apenas dias do novo ano

Exemplo:

Sub example_datediff

msgbox DateDiff("d", "1/1/2005", "12/31/2005")

End Sub


Feedback do Produto | Documentação Adicional | Marcas Registradas