Freigeben über

DATETIMEFROMPARTS - Abfragesprache in Cosmos DB (in Azure und Fabric)

  • Gilt für:: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

Die DATETIMEFROMPARTS Funktion 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>])

Arguments

Description
numeric_year Ein positiver numerischer ganzzahliger Wert für das Jahr (ISO 8601-Format yyyy).
numeric_month Ein positiver numerischer ganzzahliger Wert für den Monat (ISO 8601-Format mm).
numeric_day Ein positiver numerischer ganzzahliger Wert für den Tag (ISO 8601-Format dd).
numeric_hour Ein optionaler positiver ganzzahliger Wert für die Stunde (ISO 8601-Format hh). Ohne Angabe wird der Standardwert „0“ verwendet.
numeric_minute Ein optionaler positiver ganzzahliger Wert für die Minute (ISO 8601-Format mm). Ohne Angabe wird der Standardwert „0“ verwendet.
numeric_second Ein optionaler positiver ganzzahliger Wert für die zweite (ISO 8601-Format ss). Ohne Angabe wird der Standardwert „0“ verwendet.
numeric_second_fraction Ein optionaler positiver numerischer ganzzahliger Wert für den Bruchteil einer Sekunde (ISO 8601-Format fffffffZ). Ohne Angabe wird der Standardwert „0“ verwendet.

Rückgabetypen

Gibt einen Zeichenfolgenwert für Datum und Uhrzeit zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Erstellen von Datum und Uhrzeit aus Teilen

In diesem Beispiel wird die DATETIMEFROMPARTS Funktion verwendet, um Datums- und Uhrzeitwerte aus verschiedenen Argumenten zu erstellen.

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 Ganzzahlen ein ungültiges Datum und eine ungültige Uhrzeit erstellen würden, gibt die Funktion zurück undefined.
  • Last updated on