$toInt (Converter para Inteiro de 32 Bits)

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

$toInt (Converter para Inteiro de 32 Bits)

$toInt converte um valor em um inteiro assinado de 32 bits (int BSON). Ele aceita números, strings numéricas e booleanos; null permanece null. Usos típicos: normalizar strings inteiras de sistemas externos ou arredondar floats para inteiros. Valores fora do intervalo de 32 bits (cerca de 2,1 bilhões) geram erro — use $toLong para inteiros grandes. Strings precisam ser literais inteiros; uma string fracionária como '4.5' gera erro. É o atalho de $convert para to: int.

📝 Sintaxe

{ $toInt: <expressão> }

⚙️ Parâmetros

Retorno：Um int; null quando a entrada é null

▶ Exemplo

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

// $toInt: interpretar uma string de quantidade em inteiro
db.orders.aggregate([
  { $project: {
      qty: { $toInt: '$qtyStr' }
  } }
])

Saída：

{ '_id': 1, 'qty': 3 }

📌 Notas

• O intervalo de 32 bits é de cerca de 2,1 bilhões; além dele gera erro, então use $toLong para números grandes
• Strings precisam ser literais inteiros; '4.5' gera erro
• true vira 1 e false vira 0

🏷️ 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