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.
![]() |
---|
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())
Consulte também