Dela via

DateTimeFromParts (NoSQL-fråga)

GÄLLER FÖR: NoSQL

Returnerar ett datum- och tidssträngsvärde som konstruerats från numeriska indatavärden för olika datum- och tidsdelar.

Syntax

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

Argument

beskrivning
numeric_year Ett positivt numeriskt heltalsvärde för året. Det här argumentet är i ISO 8601-format yyyy.
numeric_month Ett positivt numeriskt heltalsvärde för månaden. Det här argumentet är i ISO 8601-format mm.
numeric_day Ett positivt numeriskt heltalsvärde för dagen. Det här argumentet är i ISO 8601-format dd.
numeric_hour (Valfritt) Ett valfritt positivt numeriskt heltalsvärde för timmen. Det här argumentet är i ISO 8601-format hh. Om det inte anges är 0standardvärdet .
numeric_minute (Valfritt) Ett valfritt positivt numeriskt heltalsvärde för minuten. Det här argumentet är i ISO 8601-format mm. Om det inte anges är 0standardvärdet .
numeric_second (Valfritt) Ett valfritt positivt numeriskt heltalsvärde för det andra. Det här argumentet är i ISO 8601-format ss. Om det inte anges är 0standardvärdet .
numeric_second_fraction (Valfritt) Ett valfritt positivt numeriskt heltalsvärde för bråkdelen av en sekund. Det här argumentet är i ISO 8601-format fffffffZ. Om det inte anges är 0standardvärdet .

Kommentar

Mer information om FORMATET ISO 8601 finns i ISO 8601.

Returtyper

Returnerar en UTC-datum- och tidssträng i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Exempel

I följande exempel används olika kombinationer av argumenten för att skapa datum- och tidssträngar. I det här exemplet används datum och tid 20 april 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"
  }
]

Kommentarer

  • Om de angivna heltalen skulle skapa ett ogiltigt datum och en ogiltig tid returnerar undefinedfunktionen .

Relaterat innehåll