DATETIMEPART – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A DATETIMEPART função retorna o valor da parte de data e hora especificada para a data e hora fornecidas.

Sintaxe

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
date_time_part	Uma cadeia de caracteres que representa uma parte de uma especificação de formato de data ISO 8601. Essa parte é usada para indicar qual aspecto da data deve ser extraída e retornada.
date_time	Uma cadeia de caracteres de data e hora UTC (Tempo Universal Coordenado) no formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

Tipos de retorno

Retorna um valor numérico que é um inteiro positivo.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Extrair partes de data e hora

Neste exemplo, a DATETIMEPART função é usada para extrair ano, mês, dia, hora, minuto, segundo, milissegundo, microssegundo e nanossegundo de uma data.

SELECT VALUE {
  getYear: DATETIMEPART("yyyy", "2016-05-29T08:30:00.1301617"),
  getMonth: DATETIMEPART("mm", "2016-05-29T08:30:00.1301617"),
  getDay: DATETIMEPART("dd", "2016-05-29T08:30:00.1301617"),
  getHour: DATETIMEPART("hh", "2016-05-29T08:30:00.1301617"),
  getMinute: DATETIMEPART("mi", "2016-05-29T08:30:00.1301617"),
  getSecond: DATETIMEPART("ss", "2016-05-29T08:30:00.1301617"),
  getMillisecond: DATETIMEPART("ms", "2016-05-29T08:30:00.1301617"),
  getMicrosecond: DATETIMEPART("mcs", "2016-05-29T08:30:00.1301617"),
  getNanosecond: DATETIMEPART("ns", "2016-05-29T08:30:00.1301617")
}

[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

Observações

• Essa função não utiliza o índice.
• O formato de data ISO 8601 especifica as partes de data e hora válidas a serem usadas com essa função: | | Formato | | --- | --- | | Ano | year, yyyyyy | | Mês | month, mmm | | Dia | day, ddd | | Hora | hour, hh | | Minuto | minute, min | | Segundo | second, ss| s | Milissegundo | millisecond, ms | | Microssegundo | microsecond, mcs | | Nanossegundo | nanosecond,ns |
• Essa função retorna undefined por estes motivos:
  • A parte de data e hora especificada é inválida.
  • A data e a hora não são uma cadeia de caracteres de data e hora do ISO 8601 válida.