$toUpper (Maiúsculas)
Última atualização: 2026-10-09
$toUpper (Maiúsculas)
$toUpper converte uma string para maiúsculas. É o operador de transformação de string mais simples, frequentemente usado para normalizar comparações ou unificar formatos de saída. Ele aceita apenas strings — outros tipos geram erro (converta com $toString antes).
| Categoria | String |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $toUpper: <expressão de string> }▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $toUpper: nomes de cidades em maiúsculas
db.users.aggregate([
{ $project: { cityUpper: { $toUpper: "$city" } } }
])Saída：
{ "_id": 1, "cityUpper": "BEIJING" }
{ "_id": 2, "cityUpper": "SHANGHAI" }📌 Notas
- Apenas strings; converta outros tipos antes
- É o inverso de $toLower
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO $toUpper afeta caracteres não latinos, como o chinês?
ANão. $toUpper afeta apenas letras latinas (A–Z); caracteres sem caixa, como chinês, japonês ou árabe, são retornados inalterados.
QO que $toUpper retorna para um campo ausente ou null?
AEle retorna null. A expressão não aborta; encadeie $ifNull depois para tratar nulos.
Q$toUpper e $toLower podem ser encadeados?
ASim, mas é inútil — o último sobrescreve o primeiro. Um padrão comum é combinar com $regexMatch para comparações sem diferenciar maiúsculas/minúsculas.
