Partilhar via


DATEPART (Expressão SSIS)

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

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

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 yy, yyyy
Trimestre qq, q
Month mm, m
Dia do ano dy, y
Dia dd, d
Semana wk, ww
Weekday dw
Hora Hh, hh, HH
Minuto mi, n
Segundo ss, s
Milissegundos Ms

Exemplos de expressões SSIS

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

Estes exemplos retornam 19.

DATEPART("HH", (DT_DATE) "2020-09-02 19:24" )
DATEPART("hh", (DT_DATE) "2020-09-02 19:24" )
DATEPART("Hh", (DT_DATE) "2020-09-02 19:24" )

Consulte Também

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