DATEDIFF (Expressão SSIS)
Retorna o número de limites de data e hora entre duas datas especificadas. O parâmetro datepart identifica quais limites de data e hora serão comparados.
Sintaxe
DATEDIFF(datepart, startdate, endate)
Argumentos
datepart
É o parâmetro que especifica qual parte da data será comparada e para a qual um valor será retornado.
startdate
É a data de início do intervalo.
endate
É a data de término do intervalo.
Tipos de resultado
DT_I4
Comentários
A tabela a seguir lista as partes de data e as abreviações reconhecidas pelo avaliador de expressão.
| datepart | Abreviações |
|---|---|
| Year | aa, aaaa |
| Trimestre | qq, q |
| Month | mm, m |
| Dia do ano | dy, y |
| Dia | dd, d |
| Semana | wk, ww |
| Weekday | dw, w |
| Hora | Hh |
| Minuto | mi, n |
| Segundo | ss, s |
| Milissegundos | Ms |
DATEDIFF retornará um resultado nulo se qualquer argumento for nulo.
Um literal de data deve ser convertido explicitamente em um dos tipos de dados de data. Para obter mais informações, consulte Integration Services Data Types.
Ocorrerá um erro se uma data não for válida, se a unidade de data ou hora não for uma cadeia de caracteres, se a data de início não for uma data ou se a data de término não for uma data.
Se a data de término for anterior à data de início, a função retornará um número negativo. Se as datas de início e término forem iguais ou estiverem dentro do mesmo intervalo, a função retornará zero.
Exemplos de expressões SSIS
Este exemplo calcula o número de dias entre dois literals de data. Se a data estiver no formato "mm/dd/aaaa", a função retornará 7.
DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")
Este exemplo retorna o número de meses entre um literal de data e a data atual.
DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())
Este exemplo retorna o número de semanas entre a data na coluna ModifiedDate e a variável YearEndDate . Se YearEndDate tiver um date tipo de dados, nenhuma conversão explícita será necessária.
DATEDIFF("Week", ModifiedDate,@YearEndDate)
Consulte Também
DATEADD (Expressão SSIS)
DATEPART (Expressão SSIS)
DAY (Expressão SSIS)
MONTH (Expressão SSIS)
YEAR (Expressão SSIS)
Funções (Expressão SSIS)