Partager via

DateTimePart (requête NoSQL)

  • Article

S’APPLIQUE À : NoSQL

Retourne la valeur de la partie de date et d’heure spécifiée pour la date et l’heure fournies.

Syntaxe

DateTimePart(<date_time_part> , <date_time>)

Arguments

Description
date_time Chaîne de date et d’heure UTC (Coordinated Universal Time) au format ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.
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 à extraire et à retourner.

Notes

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

Types de retour

Retourne une valeur numérique qui est un entier positif.

Exemples

L’exemple suivant retourne différentes parties de la date et de l’heure 29 mai 2016 08:30 UTC.

SELECT VALUE {
    getYear: DateTimePart("yyyy", "2016-05-29T08:30:00.1301617"),
    getMonth: DateTimePart("mm", "2016-05-29T08:30:00.1301617"),
    getDay: DateTimePart("dd", "2016-05-29T08:30:00.1301617"),
    getHour: DateTimePart("hh", "2016-05-29T08:30:00.1301617"),
    getMinute: DateTimePart("mi", "2016-05-29T08:30:00.1301617"),
    getSecond: DateTimePart("ss", "2016-05-29T08:30:00.1301617"),
    getMillisecond: DateTimePart("ms", "2016-05-29T08:30:00.1301617"),
    getMicrosecond: DateTimePart("mcs", "2016-05-29T08:30:00.1301617"),
    getNanosecond: DateTimePart("ns", "2016-05-29T08:30:00.1301617")
}

[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

Notes

  • Cette fonction retourne undefined pour ces raisons :
    • La partie date et heure spécifiée n’est pas valide.
    • La date et l’heure 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 |
  • Cette fonction n’utilise pas l’index.

Contenu connexe