Compartilhar via

DATETIMEFROMPARTS – 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 DATETIMEFROMPARTS função retorna um valor de cadeia de caracteres de data e hora construído a partir de valores numéricos de entrada para várias partes de data e hora.

Sintaxe

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

Arguments

Description
numeric_year Um valor inteiro numérico positivo para o ano (iso 8601 formatoyy).
numeric_month Um valor inteiro numérico positivo para o mês (formato ISO 8601 mm).
numeric_day Um valor inteiro numérico positivo para o dia (dd de formato ISO 8601).
numeric_hour Um valor inteiro numérico positivo opcional para a hora (formato ISO 8601 hh). Se esse campo não for especificado, o valor padrão será 0.
numeric_minute Um valor inteiro numérico positivo opcional para o minuto (formato ISO 8601 mm). Se esse campo não for especificado, o valor padrão será 0.
numeric_second Um valor inteiro numérico positivo opcional para o segundo (formato iso 8601 ss). Se esse campo não for especificado, o valor padrão será 0.
numeric_second_fraction Um valor inteiro numérico positivo opcional para a fração de um segundo (formato ISO 8601 fffffffZ). Se esse campo não for especificado, o valor padrão será 0.

Tipos de retorno

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

Exemplos

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

Construir data e hora de partes

Neste exemplo, a DATETIMEFROMPARTS função é usada para construir valores de data e hora de vários 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"
  }
]

Observações

  • Se os inteiros especificados criarem uma data e hora inválidas, a função retornará undefined.
  • Last updated on