$toBool (Converter para Booleano)

Última atualização: 2026-10-09

$toBool (Converter para Booleano)

$toBool converte um valor em booleano. O número 0 vira false e qualquer número diferente de zero vira true; as strings 'true' e 'false' convertem diretamente; datas viram true; null permanece null. Usos típicos: normalizar flags 0/1 de APIs em campos booleanos ou padronizar representações de verdade. É o atalho de $convert para to: bool, sem onError — converter valores inválidos gera erro.

📝 Sintaxe

{ $toBool: <expressão> }

⚙️ Parâmetros

Retorno：Um booleano; null quando a entrada é null

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $toBool: transformar uma flag 0/1 em booleano
db.devices.aggregate([
  { $project: {
      active: { $toBool: '$enabled' }
  } }
])

Saída：

{ '_id': 1, 'active': true }
{ '_id': 2, 'active': false }

📌 Notas

• 0 vira false e valores diferentes de zero viram true; a string '0' vira true
• Entrada null resulta em null, não false
• Tipos não suportados geram erro; proteja com onError de $convert

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós