• Artigo

DATEPART (expressão SSIS)

Retorna um inteiro que representa uma parte de uma data.

Sintaxe

DATEPART(datepart, date)

Argumentos

  • datepart
    É o parâmetro que especifica para qual parte da data retornar um valor novo.

  • date
    É uma expressão que retorna uma data válida ou uma cadeia de caracteres em formato de data.

Tipos de resultado

DT_I4

Comentários

DATEPART retorna um resultado nulo se o 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 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.

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

Exemplos

Este exemplo retorna o inteiro que representa o mês em um literal de data. Se a data estiver em formato mm/dd/aaaa", este exemplo retornará 11.

DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")

Este exemplo retorna o inteiro que representa o dia na coluna ModifiedDate.

DATEPART("dd", ModifiedDate)

Este exemplo retorna o inteiro que representa o ano da data atual.

DATEPART("yy",GETDATE())