Share via

  • Artigo

DATEADD (SSIS)

Retorna um novo valor DT_DBTIMESTAMP depois de adicionar um número que representa um intervalo de data e 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 da 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.

Parte da data

Abreviações

Ano

aa, aaaa

Trimestre

tt, t

Mês

mm, m

Dia do ano

da, a

Dia

dd, d

Semana

sem

Dia da semana

ds, s

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.

ObservaçãoObservação

A expressão não é validada quando um literal de data é convertido explicitamente em um destes tipos de dados de data: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 e DT_DBTIME2.

DATEADD retornará um resultado nulo se o argumento for nulo.

Ocorrem 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

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