Partager via

DateTimeAdd (requête NoSQL)

  • Article

S’APPLIQUE À : NoSQL

Retourne une valeur de chaîne de date et heure résultant de l’ajout d’une valeur de nombre spécifique de la chaîne de date et d’heure fournie.

Syntaxe

DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)

Arguments

Description
date_time_part Chaîne représentant une partie d’une spécification de format de date ISO 8601. Cette partie est utilisée pour indiquer l’aspect de la date à modifier par l’expression numérique associée.
numeric_expr Expression numérique résultant en un entier signé.
date_time Chaîne de date et d’heure UTC (Coordinated Universal Time) au format ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

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 ajoute différentes valeurs (une année, un mois, un jour, une heure) à la date du 3 juillet 2020 à minuit (00:00 UTC). L’exemple soustrait également différentes valeurs (deux ans, deux mois, deux jours, deux heures) de la même date. Enfin, cet exemple utilise une expression pour modifier les secondes de la même date.

SELECT VALUE {
    addOneYear: DateTimeAdd("yyyy", 1, "2020-07-03T00:00:00.0000000"),
    addOneMonth: DateTimeAdd("mm", 1, "2020-07-03T00:00:00.0000000"),
    addOneDay: DateTimeAdd("dd", 1, "2020-07-03T00:00:00.0000000"),
    addOneHour: DateTimeAdd("hh", 1, "2020-07-03T00:00:00.0000000"),
    subtractOneYear: DateTimeAdd("yyyy", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneMonth: DateTimeAdd("mm", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneDay: DateTimeAdd("dd", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneHour: DateTimeAdd("hh", -1, "2020-07-03T00:00:00.0000000"),
    modifySecondsExpression: DateTimeAdd("ss", 5 * -5, "2020-07-03T00:00:00.0000000")
}

[
  {
    "addOneYear": "2021-07-03T00:00:00.0000000Z",
    "addOneMonth": "2020-08-03T00:00:00.0000000Z",
    "addOneDay": "2020-07-04T00:00:00.0000000Z",
    "addOneHour": "2020-07-03T01:00:00.0000000Z",
    "subtractOneYear": "2019-07-03T00:00:00.0000000Z",
    "subtractOneMonth": "2020-06-03T00:00:00.0000000Z",
    "subtractOneDay": "2020-07-02T00:00:00.0000000Z",
    "subtractOneHour": "2020-07-02T23:00:00.0000000Z",
    "modifySecondsExpression": "2020-07-02T23:59:35.0000000Z"
  }
]

Remarques

  • Cette fonction retourne undefined pour ces raisons :
    • La partie date et heure spécifiée n’est pas valide.
    • L’expression numérique n’est pas un entier valide.
    • La date et l’heure de l’argument ne sont pas une chaîne de date et d’heure ISO 8601 valide.
  • Le format de date ISO 8601 spécifie des parties de date et d’heure valides à utiliser avec cette fonction : | | Format | | --- | --- | | Année | year, yyyy, yy | | Mois | month, mm, m | | Jour | day, dd, d | | Heure | hour, hh | | Minute | minute, mi, n | | Seconde | second, ss, s | | Milliseconde | millisecond, ms | | Microseconde | microsecond, mcs | | Nanoseconde | nanosecond, ns |

Contenu connexe