DATEPART (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.
.gif "Observação") Observaçã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())
Consulte também