Partager via

DATETIMEFROMPARTS - Langage de requête dans Cosmos DB (dans Azure et Fabric)

  • S’applique à: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

La DATETIMEFROMPARTS fonction retourne une valeur de chaîne de date et d’heure construite à partir de valeurs numériques d’entrée pour différentes parties de date et d’heure.

Syntaxe

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

Arguments

Descriptif
numeric_year Valeur entière numérique positive pour l’année (format AAAA ISO 8601).
numeric_month Valeur entière numérique positive pour le mois (format ISO 8601 mm).
numeric_day Valeur entière numérique positive pour le jour (format ISO 8601 dd).
numeric_hour Valeur entière numérique positive facultative pour l’heure (format ISO 8601 hh). Si elle n’est pas spécifiée, la valeur par défaut est 0.
numeric_minute Valeur entière numérique positive facultative pour la minute (format ISO 8601 mm). Si elle n’est pas spécifiée, la valeur par défaut est 0.
numeric_second Valeur entière numérique positive facultative pour la seconde (format ISO 8601 ss). Si elle n’est pas spécifiée, la valeur par défaut est 0.
numeric_second_fraction Valeur entière numérique positive facultative pour la fraction d’une seconde (format ISO 8601 fffffZ). Si elle n’est pas spécifiée, la valeur par défaut est 0.

Types de retour

Retourne une valeur de chaîne de date et d’heure.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Construire la date et l’heure des parties

Dans cet exemple, la DATETIMEFROMPARTS fonction est utilisée pour construire des valeurs de date et d’heure à partir de différents arguments.

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

Remarques

  • Si les entiers spécifiés créent une date et une heure non valides, la fonction retourne undefined.
  • Last updated on