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
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

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 Integration Services Data Types.

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")  

Consulte Também

DATEDIFF (Expressão SSIS)
DATEPART (Expressão SSIS)
DAY (Expressão SSIS)
MONTH (Expressão SSIS)
YEAR (Expressão SSIS)
Funções (Expressão SSIS)