$toString (Converter para String)

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

$toString (Converter para String)

$toString converte um valor em uma string. Números, datas, booleanos, ObjectIds e outros convertem de forma limpa; null permanece null. Usos típicos: transformar números em strings antes de $concat, expor ObjectIds a frontends como strings ou unificar formatos de exibição. É o atalho de $convert para to: string. A saída de data para string não tem controle de formato — use $dateToString quando um formato específico for necessário.

📝 Sintaxe

{ $toString: <expressão> }

⚙️ Parâmetros

Retorno：Uma string; null quando a entrada é null

▶ Exemplo

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

// $toString: unir um número em um rótulo
db.products.aggregate([
  { $project: {
      label: { $concat: ['SKU-', { $toString: '$skuNum' }] }
  } }
])

Saída：

{ '_id': 1, 'label': 'SKU-1001' }

📌 Notas

• Números, datas, booleanos e ObjectIds convertem todos em strings
• null resulta em null; proteja antes de concatenar
• A saída de data para string é fixa e incontrolável; use $dateToString para formatos personalizados

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