$toBool

O $toBool operador converte uma expressão em um valor booliano. Os valores boolianos são retornados como estão sem uma conversão. Valores numéricos não zero são convertidos em true enquanto os valores Decimal, Long, Double ou Int de 0 são convertidos em false. Todos os outros tipos de dados são convertidos em true.

Sintaxe

{
    $toBool: < expression >
}

Parâmetros

Exemplos

Considere este documento de exemplo da coleção de documentos das lojas.

{
    "_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
                }
            ]
        }
    ]
}

Exemplo 1: converter um valor duplo em um valor booliano

Para converter o valor do campo de latitude de um duplo para um booliano, execute uma consulta usando o operador $toBool no campo para fazer a conversão. Valores numéricos positivos são convertidos em true.

db.stores.aggregate([{
    $match: {
        _id: "b0107631-9370-4acd-aafa-8ac3511e623d"
    }
}, {
    $project: {
        originalLatitude: "$location.lat",
        latitudeAsBool: {
            $toBool: "$location.lat"
        }
    }
}])

Essa consulta retorna o seguinte resultado:

[
    {
        "_id": "b0107631-9370-4acd-aafa-8ac3511e623d",
        "originalLatitude": 72.8377,
        "latitudeAsBool": true
    }
]

Exemplo 2: converter um valor de cadeia de caracteres em um valor booliano

Para converter o valor do campo _id de uma cadeia de caracteres em um booliano, execute uma consulta usando o valor $toBool para fazer a conversão. Os valores de cadeia de caracteres são convertidos em true.

 db.stores.aggregate([{
     $match: {
         _id: "b0107631-9370-4acd-aafa-8ac3511e623d"
     }
 }, {
     $project: {
         originalId: "$_id",
         idAsBool: {
             $toBool: "$_id"
         }
     }
 }])

Essa consulta retorna o seguinte resultado:

[
    {
        "_id": "b0107631-9370-4acd-aafa-8ac3511e623d",
        "originalId": "b0107631-9370-4acd-aafa-8ac3511e623d",
        "idAsBool": true
    }
]

Exemplo 3: Converter um valor int em um valor booliano

Para converter o valor do campo sales.totalSales de inteiro para booliano, execute uma consulta usando o operador $toBool para fazer a conversão. Valores numéricos positivos são convertidos em true.

db.stores.aggregate([{
    $match: {
        _id: "b0107631-9370-4acd-aafa-8ac3511e623d"
    }
}, {
    $project: {
        originalTotalSales: "$sales.totalSales",
        totalSalesAsBool: {
            $toBool: "$sales.totalSales"
        }
    }
}])

Essa consulta retorna o seguinte resultado:

[
    {
        "_id": "b0107631-9370-4acd-aafa-8ac3511e623d",
        "originalTotalSales": 9366,
        "totalSalesAsBool": true
    }
]

Esta tabela delinea o comportamento esperado do operador $toBool com base no tipo de dados da expressão de entrada.