Compartilhar via

  • Artigo

DATEDIFF (Construtor de Relatórios 1.0)

Retorna a diferença entre os tipos de campo Data e hora (ou Hora) de início e Data e hora (ou Hora) de término. O resultado é exibido como um inteiro.

Sintaxe

DATEDIFF(interval, datetime, datetime)

interval

Especifica as unidades (ano, trimestre, mês, dia, hora, minuto, segundo ou semana) usadas para calcular a diferença de datas.

datetime

Especifica o datetime de início ou hora.

datetime

Especifica o datetime de término ou hora.

Comentários

  • Se a formula calcular a diferença entre a hora de início e a hora do término, a unidade do intervalo só pode ser HOUR, MINUTE ou SECOND.

  • Para exibir um valor datetime como um valor time é necessário formatar o campo para usar uma das seguintes cadeias de formato de datetime personalizadas na guia Número da caixa de diálogo Formatar: u, f ou s.

  • Os intervalos não diferenciam maiúsculas de minúsculas.

Os intervalos a seguir são válidos.

Intervalo

Resultados

YEAR

Retorna o número de anos entre os valores datetime ou time de início e de término.

QUARTER

Retorna o número de trimestres entre os valores datetime ou time de início e de término.

MONTH

Retorna o número de meses entre os valores datetime ou time de início e de término.

WEEK

Retorna o número de semanas entre os valores datetime ou time de início e de término.

DAY

Retorna o número de dias entre os valores datetime ou time de início e de término.

HOUR

Retorna o número de horas entre os valores datetime ou time de início e de término.

MINUTE

Retorna o número de minutos entre os valores datetime ou time de início e de término.

SECOND

Retorna o número de segundos entre os valores datetime ou time de início e de término.

Exemplo

Fórmula

Resultado

DATEDIFF(MONTH, #1/1/2009#, #3/31/2009#)

2

DATEDIFF(HOUR, #7/15/2006 3:30:29 AM#, #7/20/2006 5:30:29 AM#)

122

DATEDIFF(DAY, Sell Start Date, Sell End Date)

Retorna a diferença do número de dias de cada instância dos campos Sell Start Date e Sell End Date.