Função datediff
Retorna o valor da variante (longa) indicando o número de intervalos de tempo entre dois períodos de dia especificados.
Sintaxe datediff (intervalo, date1, date2 [, FirstdayofWeek [, FirstWeekofyear]]))
Os seguintes parâmetros nomeados estão incluídos na sintaxe da função datediff:
O intervalo de descrição parcial é necessário. Expressão da string, representando o intervalo de tempo usado para calcular a diferença de horário entre Date1 e Date2
Data1 □ Data2 Requerido; variante (data). As duas datas a serem usadas no cálculo.
O FirstdayofWeek é opcional. Especifica a constante para o primeiro dia de uma semana. Se não for especificado, o domingo é o primeiro dia.
FirstWeekofyear Opcional. Especifica a constante para a primeira semana do ano. Se não for especificado, a semana que contém 1º de janeiro é a primeira semana.
Definir o valor de configuração do parâmetro de intervalo é o seguinte: (definindo descrição)
AAA ANO
Q Temporada
M mês
y Número de dias em um ano
D Dia
W Número de dias de uma semana
WW
h
n minutos
s segundos
O valor definido do parâmetro FirstdayOfWeek é o seguinte: (Descrição do valor constante)
VbUSesySystem 0 Use as configurações da API NLS.
Vbsunday 1 domingo (padrão)
VBMONDAY 2 Segunda -feira
vbtuesday 3 terça -feira
vbwednesday 4 quarta -feira
vbthursday 5 quinta -feira
Vbfriday 6 sexta -feira
vbsaturday 7 sábado
Descrição do valor constante
VbUSesystem 0 configurado com a API NLS.
VbfirstJan1 1 começa a partir da semana que contém 1º de janeiro (padrão).
O VBFirstFourdays 2 começa com o primeiro de sua mais meia semana na semana do ano novo.
O VBFirstfullWeek 3 começa com a primeira semana sem o ano inteiro.
ilustrar:
A função datediff pode ser usada para determinar o número de intervalos de tempo especificados entre duas datas. Por exemplo, você pode usar o Datediff para calcular quantos dias separados entre duas datas ou quantas semanas haverá entre hoje e o final do ano. Para calcular o número de dias em que Date1 e Date2, você pode usar o número de dias (y) ou dia (d) de um ano. Quando o intervalo é o número de dias de uma semana (W), o datediff retorna o número de semanas durante o período de dois dias. Se Date1 for segunda -feira, o DATEDIFF calcula o número de segundas -feiras até a data2. Este número contém date2, mas não date1. No entanto, se o intervalo for semana (WW), a função DATEDIFF retorna as semanas do calendário por um período de dois dias. É obtido calculando o número de domingos entre Date1 e Date2. Se o Date2 for o domingo, o Date2 também será adicionado ao resultado da contagem do datediff; Mas não importa se a data1 é domingo ou não, isso não será contado. Se Date1 chegar mais tarde que Date2, o valor de retorno da função datediff é negativo. O parâmetro FirstdayofWeek afeta o resultado de cálculos usando o símbolo do intervalo de tempo w ou ww. Se Date1 ou Date2 for um texto de data, o ano especificado se tornará uma parte fixa dessa data. No entanto, se Date1 ou Date2 estiver entre as cotações duplas ("") e o ano for ignorado, o ano atual será inserido no código sempre que a expressão Date1 ou Date2 é calculada. Isso permite que você escreva o código do programa adequado para diferentes anos. Ao calcular a diferença do ano entre 31 de dezembro e 1º de janeiro do ano seguinte, o datdiff retorna 1 para indicar uma diferença de ano, embora seja apenas um dia.