Compartir a través de

DATETIMEBIN - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

  • Se aplica a: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

La DATETIMEBIN función devuelve un valor de cadena de fecha y hora que es el resultado de la binning (o redondeo) una parte de la cadena de fecha y hora proporcionada.

Syntax

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

Arguments

Description
date_time Cadena de fecha y hora universal coordinada (UTC) en formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.
date_time_part Cadena que representa una parte de una especificación de formato de fecha ISO 8601. Esta parte se usa para indicar qué aspecto de la fecha se va a bin.
bin_size Valor numérico opcional que especifica el tamaño del contenedor. Si no se especifica, el valor predeterminado es 1.
bin_start_date_time Cadena opcional de fecha y hora UTC en el formato ISO 8601. Si no se especifica, el valor predeterminado es la época 1970-01-01T00:00:00.000000Zde Unix .

Tipos de retorno

Devuelve un valor de cadena de fecha y hora.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Valores de fecha y hora bin

En este ejemplo, la DATETIMEBIN función se usa para binar una fecha y hora por día, hora, segundo y con tamaños de intervalo personalizados y fechas de inicio.

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"
  }
]

Observaciones

  • Esta función devuelve undefined por estas razones:
  • La parte de fecha y hora especificada no es válida.
  • El valor de tamaño de cubo no es un entero válido, es cero o es negativo.
  • La fecha y hora de cualquiera de los argumentos no es una cadena de fecha y hora ISO 8601 válida.
  • La fecha y hora de inicio de la bin precede al año "1601", la época de Windows.
  • El formato de fecha ISO 8601 especifica partes de fecha y hora válidas que se usarán con esta función: | | Formato | | --- | --- | | Año | year, yyyy, yy | | Mes | month, mm, m | | Día | day, dd, d | | Hora | hour, hh | | Minute | minute, mi, n | | Segundo | second, ss, s | | Milisegundos | millisecond, ms | | Microsegundos | microsecond, mcs | | Nanosecond | nanosecond, ns |
  • Last updated on