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

La DATETIMEBIN fonction retourne une valeur de chaîne de date et d’heure qui est le résultat de l’arrondi (ou de l’arrondi) une partie de la chaîne de date et d’heure fournie.

Syntaxe

DATETIMEBIN(<date_time>, <date_time_part> [, <bin_size>] [, <bin_start_date_time>])

Arguments

	Descriptif
date_time	Chaîne de date et d’heure UTC (Temps universel coordonné) au format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
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 à biner.
bin_size	Valeur numérique facultative spécifiant la taille de la corbeille. Si elle n’est pas spécifiée, la valeur par défaut est 1.
bin_start_date_time	Chaîne de date et d’heure UTC facultative au format ISO 8601. Si ce n’est pas spécifié, la valeur par défaut est l’époque 1970-01-01T00:00:00.000000ZUnix.

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.

Valeurs de date et d’heure du bac

Dans cet exemple, la DATETIMEBIN fonction est utilisée pour biner une date et une heure par jour, heure, seconde et avec des tailles de bac personnalisées et des dates de début.

SELECT VALUE {
  binDay: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd"),
  binHour: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh"),
  binSecond: DATETIMEBIN("2021-01-08T18:35:00.0000000", "ss"),
  binFiveHours: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh", 5),
  binSevenDaysUnixEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7),
  binSevenDaysWindowsEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}

[
  {
    "binDay": "2021-01-08T00:00:00.0000000Z",
    "binHour": "2021-01-08T18:00:00.0000000Z",
    "binSecond": "2021-01-08T18:35:00.0000000Z",
    "binFiveHours": "2021-01-08T15:00:00.0000000Z",
    "binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
    "binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
  }
]

Remarques

• Cette fonction retourne undefined pour ces raisons :
• La partie date et heure spécifiée n’est pas valide.
• La valeur de taille du bac n’est pas un entier valide, est égale à zéro ou est négative.
• La date et l’heure dans l’un ou l’autre argument ne sont pas une chaîne de date et d’heure ISO 8601 valide.
• La date et l’heure du début de la corbeille précèdent l’année « 1601 », époque Windows.
• 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 |