Cet article contient une liste d'opérateurs, de méthodes et de variables de date que vous pouvez utiliser lorsque vous travaillez avec des dates dans MongoDB.
Opérateurs de mise à jour sur le terrain
| Opérateur | Description |
|---|---|
$currentDate | Définit la valeur d'un champ à la date actuelle. Il peut être défini comme une date ou un type d'horodatage. La valeur par défaut est Date. |
Opérateurs d'expression de date (pipeline d'agrégation)
Les opérateurs de pipeline d'agrégation suivants renvoient des objets de date ou des composants d'un objet de date. Ceux-ci peuvent être utilisés pour construire des expressions à utiliser dans les étapes du pipeline d'agrégation.
| Opérateur | Description |
|---|---|
$dateFromParts | Construit un objet BSON Date à partir des éléments constitutifs de la date. |
$dateFromString | Convertit une chaîne date/heure en objet date. |
$dateToParts | Renvoie un document contenant les parties constitutives d'une date. |
$dateToString | Renvoie la date sous forme de chaîne. |
$dayOfMonth | Renvoie le jour du mois pour une date donnée sous la forme d'un nombre entre 1 et 31 . |
$dayOfWeek | Renvoie le jour de la semaine pour une date donnée sous la forme d'un nombre entre 1 (dimanche) et 7 (samedi). |
$dayOfYear | Renvoie le jour de l'année pour une date donnée sous la forme d'un nombre entre 1 et 366 (année bissextile). |
$hour | Renvoie l'heure d'une date donnée sous la forme d'un nombre entre 0 et 23 . |
$isoDayOfWeek | Renvoie le numéro du jour de la semaine d'une date donnée au format ISO 8601, allant de 1 (pour lundi) à 7 (pour le dimanche). |
$isoWeek | Renvoie le numéro de semaine d'une date donnée au format ISO 8601, allant de 1 à 53 . |
$isoWeekYear | Renvoie le numéro de l'année pour une date donnée au format ISO 8601. |
$millisecond | Renvoie les millisecondes d'une date donnée sous la forme d'un nombre entre 0 et 999 . |
$minute | Renvoie la minute pour une date donnée sous la forme d'un nombre entre 0 et 59 . |
$month | Renvoie le mois d'une date donnée sous la forme d'un nombre entre 1 (janvier) et 12 (Décembre). |
$second | Renvoie les secondes pour une date donnée sous la forme d'un nombre entre 0 et 60 (secondes intercalaires). |
$toDate | Convertit une valeur en une date. |
$week | Renvoie le numéro de semaine pour une date donnée sous la forme d'un nombre entre 0 (la semaine partielle qui précède le premier dimanche de l'année) et 53 (année bissextile). |
$year | Renvoie l'année pour une date donnée sous forme de nombre (par exemple 2021 ). |
Méthodes
La méthode suivante peut être utilisée pour renvoyer une chaîne date/heure ou un objet Date.
| Méthode | Description |
|---|---|
Date() | Renvoie soit une chaîne date/heure soit un objet Date. Vous pouvez indiquer une date. Si vous ne le faites pas, il renverra la date/heure actuelle. |
Variables système
Les variables système suivantes peuvent être utilisées pour renvoyer une valeur de date/heure ou d'horodatage lors de l'utilisation d'un pipeline d'agrégation.
| Méthode | Description |
|---|---|
NOW | Renvoie la valeur datetime actuelle. Cette variable a été introduite dans MongoDB version 4.2. |
CLUSTER_TIME | Renvoie la valeur d'horodatage actuelle. Uniquement disponible sur les jeux de réplicas et les clusters partitionnés. Cette variable a été introduite dans MongoDB version 4.2. |
