DATEADD (Expressão SSIS)
Retorna um novo valor DT_DBTIMESTAMP depois de adicionar um número que representa um intervalo de data ou hora para a parte especificada na data. O parâmetro de número deve ser avaliado como um inteiro e o parâmetro de data deve ser avaliado como uma data válida.
Sintaxe
DATEADD(datepart, number, date)
Argumentos
datepart
É o parâmetro que especifica à qual parte da data deve-se adicionar um número.number
É o valor usado para incrementar datepart. O valor deve ser um valor inteiro conhecido quando a expressão é analisada.date
É uma expressão que retorna uma data válida ou uma cadeia de caracteres em formato de data.
Tipos de resultado
DT_DBTIMESTAMP
Comentários
A tabela a seguir lista as partes de data e as abreviações reconhecidas pelo avaliador de expressão. Os nomes das partes da data não diferenciam maiúsculas de minúsculas.
Datepart |
Abreviações |
|---|---|
Ano |
yy, yyyy |
Trimestre |
qq, q |
Mês |
mm, m |
Dia do ano |
dy, y |
Dia |
dd, d |
Semana |
wk, ww |
Dia de semana |
dw, w |
Hora |
Hh |
Minuto |
mi, n |
Segundo |
ss, s |
Milissegundos |
Ms |
O argumento number deve estar disponível quando a expressão é analisada. O argumento pode ser uma constante ou variável. Você não pode usar valores de coluna porque os valores não são conhecidos quando a expressão é analisada.
O argumento datepart deve estar entre aspas.
Um literal de data deve ser convertido explicitamente em um dos tipos de dados de data. Para obter mais informações, consulte Tipos de dados do Integration Services.
DATEADD retornará um resultado nulo se o argumento for nulo.
Ocorrerão erros se uma data for inválida, se a unidade de data ou hora não for uma cadeia de caracteres ou se o incremento não for um inteiro estático.
Exemplos de expressões SSIS
Esse exemplo adiciona um mês à data atual.
DATEADD("Month", 1,GETDATE())
Esse exemplo adiciona 21 dias às datas na coluna ModifiedDate.
DATEADD("day", 21, ModifiedDate)
Esse exemplo adiciona 2 anos a uma data literal.
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")