Função datediff
descrever
Retorna o intervalo de tempo entre duas datas.
gramática
Datediff (intervalo, date1, date2 [, FirstdayOfWeek] [, FirstWeekofyear]])
A sintaxe da função datediff tem os seguintes parâmetros:
Descrição do parâmetro
O intervalo é necessário. Uma expressão de string que representa o intervalo de tempo usado para calcular Date1 e Date2. Para valores, consulte a seção Configurações.
Date1, Date2 é necessário. Expressão de data. Duas datas usadas para cálculo.
O FirstdayofWeek é opcional. Especifica a constante para o primeiro dia da semana. Se não for especificado, o padrão é domingo. Para valores, consulte a seção Configurações.
O FirstWeekofyear é opcional. Especifique a constante para a primeira semana do ano. Se não for especificado, o padrão é a semana em 1º de janeiro. Para valores, consulte a seção Configurações.
configurar
O parâmetro de intervalo pode ter os seguintes valores:
Definindo descrição
AAA
M mês
y Anos dias
Dia
W Número de dias de uma semana
www.
H horas
m minutos
s segundos
O parâmetro FirstdayofWeek pode ter os seguintes valores:
Descrição do valor constante
O VBUSESYSTEM0 usa as configurações da API de suporte ao idioma regional (NLS).
Vbsunday1 Domingo (padrão)
VbMOday2 Segunda -feira
VBTuesDay3 Terça -feira
vbwednesday4 quarta -feira
vbthursday 5 quinta -feira
Vbfriday6 sexta -feira
vbsaturday7 sábado
O parâmetro FirstWeekOfyear pode ter os seguintes valores:
Descrição do valor constante
O VBUSESYSTEM0 usa as configurações da API de suporte ao idioma regional (NLS).
O VBFirstJan11 começa a partir da semana em 1º de janeiro (padrão).
O VBFirstFourDays2 começa com a primeira semana de pelo menos quatro dias no Ano Novo.
O VBFirstfullWeek3 começa com a primeira semana completa do Ano Novo.
ilustrar
A função datediff é usada para determinar o número de intervalos de tempo especificados que existem entre duas datas. Por exemplo, você pode usar o Datediff para calcular o número de dias em que as duas datas diferem ou o número de semanas entre o mesmo dia e o último dia do ano.
Para calcular o número de dias entre Date1 e Date2, você pode usar "dias de um ano" ("y") ou "dias" ("d"). Quando o intervalo é "datas da semana" ("W"), o datediff retorna o número de semanas entre as duas datas. Se Date1 for segunda -feira, o DATEDIFF calcula o número de segundas -feiras antes do Date2. Este resultado contém date2 e não date1. Se o intervalo for "semana" ("WW"), a função datediff retorna o número de semanas entre duas datas na tabela de calendário. A função calcula o número de domingos entre Date1 e Date2. Se o Date2 for domingo, o datediff calculará o Date2, mas mesmo que o Date1 seja domingo, o Date1 não será calculado.