descrever
Retorna o intervalo de tempo entre duas datas.
gramática
Datediff (intervalo, date1, date2 [, FirstdayOfWeek [, FirstWeekofyear]])
A gramática da função datediff tem os seguintes parâmetros:
Descrição do parâmetro
Intervalo deve ser selecionado. A expressão da string indica o intervalo de tempo entre Date1 e Date2. Para valores, consulte a parte da configuração.
Date1, Date2 deve ser selecionado. Expressão de data. Duas datas para cálculo.
Firstdayofwek opcional. A constante no primeiro dia na semana especificada. Se não for especificado, o padrão é domingo. Para valores, consulte a parte da configuração.
FirstWeekofyear Opcional. Especifique a constante da primeira semana do ano. Se não for especificado, é padrão na semana de 1º de janeiro. Para valores, consulte a parte da configuração.
configurar
O parâmetro de intervalo pode ter os seguintes valores:
Definir descrição
AAA ANO
Q TRIMERIOR
N mês
Y Um ano
D Dia
W por uma semana
Semana da Segunda Guerra Mundial
H hora
M minutos
S segundos
O parâmetro FirstdayofWeek pode ter o seguinte valor:
Descrição do valor específico
O VbUSesySystem 0 usa as configurações da API de suporte à linguagem regional (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
O parâmetro FirstWeekOfyear pode ter o seguinte valor:
Descrição do valor específico
O VbUSesySystem 0 usa as configurações da API de suporte à linguagem regional (NLS).
VBFirstJan1 1 começa a partir da semana de 1º de janeiro (padrão).
O VBFirstFourDays 2 começa a partir da primeira semana de pelo menos quatro dias no Ano Novo.
O VBFirstfulllwek 3 começa com a primeira semana completa no Ano Novo.
ilustrar
A função datediff é usada para determinar o número de intervalo de tempo especificado entre duas datas. Por exemplo, o datediff pode ser usado para calcular o número de dias de diferença entre duas datas ou o número semanal entre o dia e o último dia do ano.
Para calcular o número de dias entre 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 (W) da semana (W), o Datediff retorna o número semanal entre duas datas. Se a data1 for segunda -feira, o número de datediff é calculado até a data2 antes do número de segunda -feira. Este resultado contém date2 sem data1. Se o intervalo for semana (WW), a função datediff retorna o número semanal entre duas datas na tabela de calendário. O número de funções entre Date1 e Date2 é calculado. Se o Date2 for domingo, o datediff calculará o Date2, mas mesmo que o Date1 seja domingo, o Date1 não será calculado.
Se a data1 for posterior a data2, a função datediff retorna números negativos.
O parâmetro FirstdayofWeek afeta o cálculo do símbolo do intervalo WW.
Se Date1 ou Date2 for um texto de data, o ano especificado se tornará uma parte fixa da data. No entanto, se o Date1 ou Date2 estiver incluído nas cotações () e omitido no ano, cada vez que a expressão Data1 ou Date2 é calculada no código, ela será inserida no ano atual. Dessa forma, você pode escrever um código de programa adequado para diferentes anos.
Quando o intervalo é o ano (AAA), em comparação com 1º de janeiro de 31 de dezembro e o próximo ano, embora haja apenas um dia, o datediff retorna 1 para indicar uma diferença de ano.
O exemplo abaixo usa a função datediff para mostrar o número de dias entre hoje e a data fornecida:
Função Difadatate (Thedate)
Diffadate = Número de dias começando do mesmo dia: & Datingiff (D, agora, Thedate)
Função final