Delen via

DATETIMEFROMPARTS - Querytaal in Cosmos DB (in Azure en Fabric)

  • Van toepassing op: ✅ Azure Cosmos DB, ✅ Cosmos DB in Microsoft Fabric

De DATETIMEFROMPARTS functie 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>])

Arguments

Description
numeric_year Een positief numeriek geheel getal voor het jaar (ISO 8601-notatie jjjj).
numeric_month Een positief numeriek geheel getal voor de maand (ISO 8601-notatie mm).
numeric_day Een positief numeriek geheel getal voor de dag (ISO 8601-indeling dd).
numeric_hour Een optionele positieve numerieke geheel getalwaarde voor het uur (ISO 8601-notatie uu). Als dit niet is opgegeven, is de standaardwaarde 0.
numeric_minute Een optionele positieve numerieke geheel getalwaarde voor de minuut (ISO 8601-notatie mm). Als dit niet is opgegeven, is de standaardwaarde 0.
numeric_second Een optionele positieve numerieke geheel getalwaarde voor de tweede (ISO 8601-notatie ss). Als dit niet is opgegeven, is de standaardwaarde 0.
numeric_second_fraction Een optioneel positief numeriek geheel getal voor de breuk van een seconde (ISO 8601-indeling fffffffZ). Als dit niet is opgegeven, is de standaardwaarde 0.

Retourtypen

Retourneert een tekenreekswaarde voor datum en tijd.

Voorbeelden

Deze sectie bevat voorbeelden van het gebruik van deze querytaalconstructie.

Datum en tijd van onderdelen samenstellen

In dit voorbeeld wordt de DATETIMEFROMPARTS functie gebruikt om datum- en tijdwaarden van verschillende argumenten samen te stellen.

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.
  • Last updated on