Freigeben über


DateTimeFromParts (NoSQL-Abfrage)

GILT FÜR: NoSQL

Gibt einen Datums- und Uhrzeitzeichenfolgenwert zurück, der aus numerischen Eingabewerten für verschiedene Datums- und Uhrzeitteile erstellt wurde.

Syntax

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

Argumente

BESCHREIBUNG
numeric_year Ein positiver numerischer ganzzahliger Wert für das Jahr. Dieses Argument hat das ISO 8601-Format yyyy.
numeric_month Ein positiver numerischer ganzzahliger Wert für den Monat. Dieses Argument hat das ISO 8601-Format mm.
numeric_day Ein positiver numerischer ganzzahliger Wert für den Tag. Dieses Argument hat das ISO 8601-Format dd.
numeric_hour(Optional) Ein optionaler positiver numerischer ganzzahliger Wert für die Stunde. Dieses Argument hat das ISO 8601-Format hh. Wenn Sie hier nichts angeben, lautet der Standardwert 0.
numeric_minute(Optional) Ein optionaler positiver numerischer ganzzahliger Wert für die Minute. Dieses Argument hat das ISO 8601-Format mm. Wenn Sie hier nichts angeben, lautet der Standardwert 0.
numeric_second(Optional) Ein optionaler positiver numerischer ganzzahliger Wert für die Sekunde. Dieses Argument hat das ISO 8601-Format ss. Wenn Sie hier nichts angeben, lautet der Standardwert 0.
numeric_second_fraction(Optional) Ein optionaler positiver numerischer ganzzahliger Wert für den Sekundenbruchteil. Dieses Argument hat das ISO 8601-Format fffffffZ. Wenn Sie hier nichts angeben, lautet der Standardwert 0.

Hinweis

Weitere Informationen zum ISO 8601-Format finden Sie unter ISO 8601.

Rückgabetypen

Gibt eine Datums- und Uhrzeitzeichenfolge im ISO 8601-Format YYYY-MM-DDThh:mm:ss.fffffffZ zurück.

Beispiele

Im folgenden Beispiel werden verschiedene Kombinationen der Argumente verwendet, um Datums- und Uhrzeitzeichenfolgen zu erstellen. In diesem Beispiel werden das Datum und die Uhrzeit 20. April 2017 13:15 UTC verwendet.

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

Bemerkungen

  • Wenn die angegebenen ganzen Zahlen ein ungültiges Datum und eine ungültige Uhrzeit erzeugen würden, gibt die Funktion undefined zurück.