DATEDIFF (Expressão de SSIS)

Aplica-se a:SQL Server SSIS Integration Runtime em Azure Data Factory

Devolve o número de limites de data e hora cruzados entre duas datas especificadas. O parâmetro datepart identifica quais os limites de data e hora a comparar.

Sintaxe

  
DATEDIFF(datepart, startdate, endate)  

Arguments

datepart
É o parâmetro que especifica qual parte da data comparar e devolver um valor.

data de início
É a data de início do intervalo.

endate
É a data final do intervalo.

Tipos de Resultados

DT_I4

Observações

A tabela seguinte lista as partes de data e abreviaturas reconhecidas pelo avaliador de expressões.

Parte da Data	Abbreviations
Ano	yy, yyyy
Trimestre	qq, q
Mês	mm, m
Dia do ano	dy, y
Day	dd, d
Semana	WK, WW
Dia da Semana	dw, w
Hora	Hh
Minuto	mi, n
Second	ss, s
Milissegundo	Sra.

DATEDIFF devolve um resultado nulo se qualquer argumento for nulo.

Um literal de data deve ser explicitamente convertido para um dos tipos de dados de data. Para obter mais informações, consulte Tipos de dados do Integration Services.

Ocorre um erro se uma data não for válida, se a unidade de data ou hora não for uma cadeia, se a data de início não for uma data, ou se a data de fim não for uma data.

Se a data de fim for anterior à data de início, a função devolve um número negativo. Se as datas de início e fim forem iguais ou estiverem dentro do mesmo intervalo, a função devolve zero.

Exemplos de Expressões SSIS

Este exemplo calcula o número de dias entre dois literais de data. Se a data estiver em formato "mm/dd/yyyy", a função devolve 7.

DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")  

Este exemplo devolve o número de meses entre uma data literal e a data atual.

DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())  

Este exemplo devolve o número de semanas entre a data na coluna Modified Date e a variável YearEndDate . Se YearEndDate tiver o tipo de dados data, não é necessária uma conversão explícita.

DATEDIFF("Week", ModifiedDate,@YearEndDate)  

Ver também

DATEADD (Expressão SSIS)
DATEPART (Expressão SSIS)
DAY (Expressão SSIS)
MÊS (Expressão SSIS)
ANO (Expressão SSIS)
Funções (Expressão SSIS)