Compartir a través de

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

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

La DATETIMEFROMPARTS función devuelve un valor de cadena de fecha y hora construido a partir de valores numéricos de entrada para varias partes de fecha y hora.

Syntax

DATETIMEFROMPARTS(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>] [, <numeric_minute>] [, <numeric_second>] [, <numeric_second_fraction>])

Arguments

Description
numeric_year Valor entero numérico positivo para el año (formato ISO 8601 aaaa).
numeric_month Valor entero numérico positivo para el mes (formato ISO 8601 mm).
numeric_day Valor entero numérico positivo para el día (dd con formato ISO 8601).
numeric_hour Un valor entero numérico positivo opcional para la hora (formato HH iso 8601). Si no se especifica, el valor predeterminado es 0.
numeric_minute Valor entero numérico positivo opcional para el minuto (formato ISO 8601 mm). Si no se especifica, el valor predeterminado es 0.
numeric_second Valor entero numérico positivo opcional para el segundo (ss de formato ISO 8601). Si no se especifica, el valor predeterminado es 0.
numeric_second_fraction Valor entero numérico positivo opcional para la fracción de un segundo (formato fffffffZ de formato ISO 8601). Si no se especifica, el valor predeterminado es 0.

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.

Construcción de fecha y hora a partir de partes

En este ejemplo, la DATETIMEFROMPARTS función se usa para construir valores de fecha y hora a partir de varios argumentos.

SELECT VALUE {
  constructMinArguments: DATETIMEFROMPARTS(2017, 4, 20),
  constructMinEquivalent: DATETIMEFROMPARTS(2017, 4, 20, 0, 0, 0, 0),
  constructAllArguments: DATETIMEFROMPARTS(2017, 4, 20, 13, 15, 20, 3456789),
  constructPartialArguments: DATETIMEFROMPARTS(2017, 4, 20, 13, 15),
  constructInvalidArguments: DATETIMEFROMPARTS(-2000, -1, -1)
}

[
  {
    "constructMinArguments": "2017-04-20T00:00:00.0000000Z",
    "constructMinEquivalent": "2017-04-20T00:00:00.0000000Z",
    "constructAllArguments": "2017-04-20T13:15:20.3456789Z",
    "constructPartialArguments": "2017-04-20T13:15:00.0000000Z"
  }
]

Observaciones

  • Si los enteros especificados crearían una fecha y hora no válidas, la función devuelve undefined.
  • Last updated on