Partilhar via

DATETIMEBIN - 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 DATETIMEBIN função retorna um valor de cadeia de caracteres de data e hora que é o resultado da vinculação (ou arredondamento) de uma parte da cadeia de caracteres de data e hora fornecida.

Sintaxe

DATETIMEBIN(<date_time>, <date_time_part> [, <bin_size>] [, <bin_start_date_time>])

Arguments

Description
date_time Uma cadeia de caracteres de data e hora UTC (Tempo Universal Coordenado) no formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.
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 deve ser compartimentado.
bin_size Um valor numérico opcional que especifica o tamanho do compartimento. Se não for especificado, o valor padrão será 1.
bin_start_date_time Uma cadeia de caracteres de data e hora UTC opcional no formato ISO 8601. Se não for especificado, o valor padrão é a época 1970-01-01T00:00:00.000000ZUnix .

Tipos de devolução

Retorna um valor de cadeia de caracteres de data e hora.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Valores de data e hora do compartimento

Neste exemplo, a função é usada para compartimentar uma data e hora por dia, hora, segundo e com tamanhos de compartimento DATETIMEBIN personalizados e datas de início.

SELECT VALUE {
  binDay: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd"),
  binHour: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh"),
  binSecond: DATETIMEBIN("2021-01-08T18:35:00.0000000", "ss"),
  binFiveHours: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh", 5),
  binSevenDaysUnixEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7),
  binSevenDaysWindowsEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}

[
  {
    "binDay": "2021-01-08T00:00:00.0000000Z",
    "binHour": "2021-01-08T18:00:00.0000000Z",
    "binSecond": "2021-01-08T18:35:00.0000000Z",
    "binFiveHours": "2021-01-08T15:00:00.0000000Z",
    "binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
    "binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
  }
]

Observações

  • Esta função retorna undefined pelos seguintes motivos:
  • A parte de data e hora especificada é inválida.
  • O valor do tamanho do compartimento não é um número inteiro válido, é zero ou é negativo.
  • A data e a hora em ambos os argumentos não são uma cadeia de caracteres de data e hora ISO 8601 válida.
  • A data e a hora para o início do caixote do lixo precedem o ano '1601'', a época do Windows.
  • 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 |
  • Last updated on