Delen via

DateTimeFromParts (NoSQL-query)

  • Artikel

VAN TOEPASSING OP: NoSQL

Retourneert een tekenreekswaarde voor datum en tijd die is samengesteld op basis van numerieke invoerwaarden voor verschillende datum- en tijdonderdelen.

Syntaxis

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

Argumenten

Beschrijving
numeric_year Een positief numeriek geheel getal voor het jaar. Dit argument heeft de ISO 8601-indeling yyyy.
numeric_month Een positief numeriek geheel getal voor de maand. Dit argument heeft de ISO 8601-indeling mm.
numeric_day Een positief numeriek geheel getal voor de dag. Dit argument heeft de ISO 8601-indeling dd.
numeric_hour(Optioneel) Een optionele positieve numerieke geheel getalwaarde voor het uur. Dit argument heeft de ISO 8601-indeling hh. Als dit niet is opgegeven, is 0de standaardwaarde .
numeric_minute(Optioneel) Een optionele positieve numerieke geheel getalwaarde voor de minuut. Dit argument heeft de ISO 8601-indeling mm. Als dit niet is opgegeven, is 0de standaardwaarde .
numeric_second(Optioneel) Een optionele positieve numerieke geheel getalwaarde voor de seconde. Dit argument heeft de ISO 8601-indeling ss. Als dit niet is opgegeven, is 0de standaardwaarde .
numeric_second_fraction(Optioneel) Een optionele positieve numerieke geheel getalwaarde voor de breuk van een seconde. Dit argument heeft de ISO 8601-indeling fffffffZ. Als dit niet is opgegeven, is 0de standaardwaarde .

Notitie

Zie ISO 8601 voor meer informatie over de ISO 8601-indeling.

Retourtypen

Retourneert een UTC-datum- en tijdtekenreeks in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.

Voorbeelden

In het volgende voorbeeld worden verschillende combinaties van de argumenten gebruikt om datum- en tijdtekenreeksen te maken. In dit voorbeeld wordt de datum en tijd van 20 april 2017 13:15 UTC gebruikt.

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

Opmerkingen

  • Als de opgegeven gehele getallen een ongeldige datum en tijd zouden maken, retourneert undefinedde functie.

Gerelateerde inhoud