Partager via

DateTimeFromParts (requête NoSQL)

  • Article

S’APPLIQUE À : NoSQL

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

Description
numeric_year Valeur entière numérique positive pour l’année. Cet argument est au format ISO 8601 yyyy.
numeric_month Valeur entière numérique positive pour le mois. Cet argument est au format ISO 8601 mm.
numeric_day Valeur entière numérique positive pour le jour. Cet argument est au format ISO 8601 dd.
numeric_hour(Facultatif) Valeur d’entier numérique positif facultative pour l’heure. Cet argument est au format ISO 8601 hh. Si elle n’est pas spécifiée, la valeur par défaut est 0.
numeric_minute(Facultatif) Valeur d’entier numérique positif facultative pour la minute. Cet argument est au format ISO 8601 mm. Si elle n’est pas spécifiée, la valeur par défaut est 0.
numeric_second(Facultatif) Valeur d’entier numérique positif facultative pour la seconde. Cet argument est au format ISO 8601 ss. Si elle n’est pas spécifiée, la valeur par défaut est 0.
numeric_second_fraction(Facultatif) Valeur d’entier numérique positif facultative pour la fraction de seconde. Cet argument est au format ISO 8601 fffffffZ. Si elle n’est pas spécifiée, la valeur par défaut est 0.

Notes

Pour plus d’informations sur le format ISO 8601, consultez ISO 8601.

Types de retour

Retourne une chaîne de date et d’heure UTC au format ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Exemples

L’exemple suivant utilise différentes combinaisons des arguments pour créer des chaînes de date et d’heure. Cet exemple utilise la date et l’heure 20 avril 2017 13:15 UTC.

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.

Contenu connexe