Compartilhar via

DateTimeFromParts (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

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>])

Argumentos

Descrição
numeric_year Um valor inteiro numérico positivo para o ano. Esse argumento está no formato ISO 8601 yyyy.
numeric_month Um valor inteiro numérico positivo para o mês. Este argumento está no formato ISO 8601 mm.
numeric_day Um valor inteiro numérico positivo para o dia. Esse argumento está no formato ISO 8601 dd.
numeric_hour(Opcional) Um valor inteiro numérico positivo opcional para a hora. Esse argumento está no formato ISO 8601 hh. Se esse campo não for especificado, o valor padrão será 0.
numeric_minute(Opcional) Um valor inteiro numérico positivo opcional para o minuto. Este argumento está no formato ISO 8601 mm. Se esse campo não for especificado, o valor padrão será 0.
numeric_second(Opcional) Um valor inteiro numérico positivo opcional para o segundo. Esse argumento está no formato ISO 8601 ss. Se esse campo não for especificado, o valor padrão será 0.
numeric_second_fraction(Opcional) Um valor inteiro numérico positivo opcional para o fracionário de um segundo. Esse argumento está no formato ISO 8601 fffffffZ. Se esse campo não for especificado, o valor padrão será 0.

Observação

Para obter mais informações sobre o formato ISO 8601, consulte ISO 8601.

Tipos de retorno

Retorna uma cadeia de caracteres de data e hora UTC no formato ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Exemplos

O exemplo a seguir usa várias combinações de argumentos para criar cadeia de caracteres de data e hora. Este exemplo usa a data e a hora 20 de abril de 2017 13:15 UTC.

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

Comentários

  • Se os números inteiros especificados criarem uma data e hora inválidas, a função retornará undefined.

Conteúdo relacionado