Partilhar via

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

  • Aplica-se a: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft 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. Esta parte é usada para indicar qual aspeto da data extrair e retornar.
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 devolução

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

Examples

Esta seção contém exemplos de como usar essa construção 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

  • Esta função não utiliza o índice.
  • O formato de data ISO 8601 especifica as peças de data e hora válidas a serem usadas com esta função: | | Formato | | --- | --- | | Ano | year, yyyy, yy | | Mês | month, mm, m | | Dia | day, dd, d | | Hora | hour, hh | | Ata | minute, mi, n | | Segundo | second, ss, s | | Milissegundo | millisecond, ms | | Microssegundo | microsecond, mcs | | Nanossegundo | nanosecond, ns |
  • Esta função retorna undefined pelos seguintes 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 válida da ISO 8601 .
  • Last updated on