Partilhar via


datetime_part()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Extrai a parte de data solicitada como um valor inteiro.

Aliases preteridos: datepart()

Sintaxe

datetime_part( parte,datetime)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
parte string ✔️ Medição do tempo para extrair da data. Veja os valores possíveis.
data datetime ✔️ A data completa da qual extrair a parte.

Valores possíveis da peça

  • Ano
  • Trimestre
  • Mês
  • week_of_year
  • Dia
  • DiadeAno
  • Hora
  • Minuto
  • Segundo
  • Milissegundos
  • Microssegundo
  • Nanossegundos

Devoluções

Retorna um inteiro que representa a parte extraída.

Observação

week_of_year Retorna um inteiro que representa o número da semana. O número da semana é calculado a partir da primeira semana de um ano, que é a que inclui a primeira quinta-feira.

Exemplos

O exemplo a seguir extrai o ano, trimestre, mês, semana do ano, dia, dia do ano, hora, minuto, segundo, milissegundo, microssegundo e nanossegundo de um valor data/hora especificado.

let dt = datetime(2017-10-30 01:02:03.7654321); 
print 
year = datetime_part("year", dt),
quarter = datetime_part("quarter", dt),
month = datetime_part("month", dt),
weekOfYear = datetime_part("week_of_year", dt),
day = datetime_part("day", dt),
dayOfYear = datetime_part("dayOfYear", dt),
hour = datetime_part("hour", dt),
minute = datetime_part("minute", dt),
second = datetime_part("second", dt),
millisecond = datetime_part("millisecond", dt),
microsecond = datetime_part("microsecond", dt),
nanosecond = datetime_part("nanosecond", dt)

Realização

ano trimestre mês semanadeano Dia dia do ano hora minuto segundo milissegundos microssegundos nanossegundos
2017 4 10 44 30 303 1 2 3 765 765432 765432100

Observação

weekofyear é uma variante obsoleta de week_of_year peça. weekofyear não estava em conformidade com a norma ISO 8601; a primeira semana de um ano foi definida como a semana com a primeira quarta-feira do ano. week_of_year está em conformidade com a norma ISO 8601; a primeira semana de um ano é definida como a semana com a primeira quinta-feira do ano. [Para obter mais informações], consulte as datas da semana ISO 8601.