$ceil (Arredondar para Cima)
Última atualização: 2026-10-09
$ceil (Arredondar para Cima)
$ceil retorna o menor inteiro maior ou igual a um número dado — arredondando para cima. É usado em cálculos de paginação ou estimativas de capacidade onde é preciso arredondar para cima, como 7.5 itens exigindo 8 em estoque. Um argumento null ou ausente resulta em null, e uma entrada inteira passa inalterada. É o oposto de $floor e difere de $trunc nos negativos: -1.2 vira -1 com $ceil, -1 com $trunc e -2 com $floor.
| Categoria | Matemática |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $ceil: <expressão numérica> }⚙️ Parâmetros
| valor numérico | Um valor numérico ou uma expressão que resolva para um. |
|---|
Retorno：O menor inteiro maior ou igual à entrada; null quando null ou ausente
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $ceil: arredondar caixas para cima com 12 itens por caixa
db.orders.aggregate([
{ $project: {
boxes: { $ceil: { $divide: ['$quantity', 12] } }
} }
])Saída：
{ '_id': 1, 'boxes': 1 }
{ '_id': 2, 'boxes': 2 }📌 Notas
- Nos negativos ele vai na direção oposta ao $floor: $ceil(-1.2) é -1 enquanto $floor(-1.2) é -2
- Uma entrada inteira passa inalterada
- Argumentos null ou ausentes resultam em null
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é a diferença entre $ceil e $floor?
A$ceil arredonda para cima e $floor arredonda para baixo; $ceil(-1.2) é -1 enquanto $floor(-1.2) é -2.
QComo $ceil lida com números negativos?
AEle ainda arredonda para cima, em direção ao infinito positivo: -1.2 vira -1 e -2.8 vira -2.
QO $ceil consegue manter um número específico de casas decimais?
ANão — $ceil só produz inteiros; use o segundo argumento de $round ou $trunc para manter decimais.
