Condividi tramite

DateTimeFromParts (query NoSQL)

  • Articolo

SI APPLICA A: NoSQL

Restituisce un valore stringa di data e ora costruito dai valori numerici di input per varie parti di data e ora.

Sintassi

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

Argomenti

Descrizione
numeric_year Valore intero numerico positivo per l'anno. Questo argomento è nel formato yyyyISO 8601 .
numeric_month Valore intero numerico positivo per il mese. Questo argomento è nel formato mmISO 8601 .
numeric_day Valore intero numerico positivo per il giorno. Questo argomento è nel formato ddISO 8601 .
numeric_hour(opzionale) Valore numerico positivo facoltativo per l'ora. Questo argomento è nel formato hhISO 8601 . Se non è specificato, il valore predefinito è 0.
numeric_minute(opzionale) Valore numerico positivo facoltativo per il minuto. Questo argomento è nel formato mmISO 8601 . Se non è specificato, il valore predefinito è 0.
numeric_second(opzionale) Valore numerico positivo facoltativo per il secondo. Questo argomento è nel formato ssISO 8601 . Se non è specificato, il valore predefinito è 0.
numeric_second_fraction(opzionale) Valore numerico positivo facoltativo per la frazione di un secondo. Questo argomento è nel formato fffffffZISO 8601 . Se non è specificato, il valore predefinito è 0.

Nota

Per altre informazioni sul formato ISO 8601, vedere ISO 8601.

Tipi restituiti

Restituisce una stringa di data e ora UTC nel formato YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Esempi

Nell'esempio seguente vengono utilizzate varie combinazioni degli argomenti per creare stringhe di data e ora. Questo esempio usa la data e l'ora del 20 aprile 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"
  }
]

Osservazioni:

  • Se gli interi specificati creano una data e un'ora non valide, la funzione restituisce undefined.

Contenuto correlato