Partager via

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

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

La DATETIMEPART fonction retourne la valeur de la partie date et heure spécifiées pour la date et l’heure fournies.

Syntaxe

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

Descriptif
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 quel aspect de la date à extraire et retourner.
date_time Chaîne de date et d’heure UTC (Temps universel coordonné) au format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Types de retour

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

Examples

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

Extraire des parties de date et d’heure

Dans cet exemple, la fonction est utilisée pour extraire l’année, le mois, le jour, l’heure, la minute, la seconde, la milliseconde, la DATETIMEPART microseconde et la nanoseconde à partir d’une date.

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

Remarques

  • Cette fonction n’utilise pas l’index.
  • Le format de date ISO 8601 spécifie les 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 | | Deuxièmement | second, ss, s | | | Millisecondes | millisecond, ms | | | Microseconde | microsecond, mcs | | Nanoseconde | nanosecond, ns |
  • 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.
  • Last updated on