$toDate

L’opérateur $toDate convertit une valeur spécifiée en type date.

Syntaxe

{
  $toDate: <expression>
}

Paramètres

Paramètre	Descriptif
expression	Expression qui peut être convertie en date. Les formats pris en charge sont les suivants : chaînes de date ISO, millisecondes depuis l’époque Unix (nombre), ObjectId et Timestamp. Si l’expression ne peut pas être convertie en date, l’opération retourne une erreur.

Examples

Considérez cet exemple de document de la collection des magasins.

{
    "_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
    "name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
    "location": {
        "lat": -89.2384,
        "lon": -46.4012
    },
    "staff": {
        "totalStaff": {
            "fullTime": 8,
            "partTime": 20
        }
    },
    "sales": {
        "totalSales": 75670,
        "salesByCategory": [
            {
                "categoryName": "Wine Accessories",
                "totalSales": 34440
            },
            {
                "categoryName": "Bitters",
                "totalSales": 39496
            },
            {
                "categoryName": "Rum",
                "totalSales": 1734
            }
        ]
    },
    "promotionEvents": [
        {
            "eventName": "Unbeatable Bargain Bash",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 6,
                    "Day": 23
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 7,
                    "Day": 2
                }
            },
            "discounts": [
                {
                    "categoryName": "Whiskey",
                    "discountPercentage": 7
                },
                {
                    "categoryName": "Bitters",
                    "discountPercentage": 15
                },
                {
                    "categoryName": "Brandy",
                    "discountPercentage": 8
                },
                {
                    "categoryName": "Sports Drinks",
                    "discountPercentage": 22
                },
                {
                    "categoryName": "Vodka",
                    "discountPercentage": 19
                }
            ]
        },
        {
            "eventName": "Steal of a Deal Days",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 21
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 29
                }
            },
            "discounts": [
                {
                    "categoryName": "Organic Wine",
                    "discountPercentage": 19
                },
                {
                    "categoryName": "White Wine",
                    "discountPercentage": 20
                },
                {
                    "categoryName": "Sparkling Wine",
                    "discountPercentage": 19
                },
                {
                    "categoryName": "Whiskey",
                    "discountPercentage": 17
                },
                {
                    "categoryName": "Vodka",
                    "discountPercentage": 23
                }
            ]
        }
    ]
}

Exemple 1 : Convertir un timestamp en date

Pour convertir la valeur du champ lastUpdated d’un horodatage Unix au format de date, exécutez une requête à l’aide de l’opérateur $toDate pour effectuer la conversion.

db.stores.aggregate([{
        $match: {
            _id: "905d1939-e03a-413e-a9c4-221f74055aac"
        }
    },
    {
        $project: {
            name: 1,
            lastUpdated: 1,
            lastUpdatedAsDate: {
                $toDate: "$lastUpdated"
            }
        }
    }
])

Cette requête retourne le résultat suivant :

[
  {
    "_id": "905d1939-e03a-413e-a9c4-221f74055aac",
    "name": "Trey Research | Home Office Depot - Lake Freeda",
    "lastUpdated": { "t": 1729983325, "i": 1 },
    "lastUpdatedAsDate": ISODate("2024-10-26T22:55:25.000Z")
  }
]