$toLower (Minúsculas)

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

$toLower (Minúsculas)

$toLower converte uma string para minúsculas — um operador fundamental de normalização. É usado para unificar formatos de armazenamento, construir chaves de consulta sem diferenciar maiúsculas/minúsculas (com índices) ou limpar entrada do usuário. Aceita apenas strings; outros tipos geram erro, então converta com $toString antes. É a inversa de $toUpper. Caracteres sem caixa (como o chinês) passam inalterados.

📝 Sintaxe

{ $toLower: <expressão de string> }

⚙️ Parâmetros

Retorno：A string em minúsculas.

▶ Exemplo

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

// $toLower: normalizar e-mails para minúsculas
db.users.aggregate([
  { $project: { emailLower: { $toLower: '$email' } } }
])

Saída：

{ "_id": 1, "emailLower": "alice@example.com" }
{ "_id": 2, "emailLower": "bob@example.com" }

📌 Notas

• Apenas strings — converta números e datas antes
• Inversa de $toUpper
• Caracteres sem caixa, como o chinês, passam inalterados

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