$isoDayOfWeek (Dia da Semana ISO)
Última atualização: 2026-10-09
$isoDayOfWeek (Dia da Semana ISO)
$isoDayOfWeek retorna o número do dia da semana conforme ISO 8601: 1 é segunda-feira, 7 é domingo — diferente de $dayOfWeek, onde domingo é 1. Combine com $isoWeek e $isoWeekYear para estatísticas semanais que seguem o padrão internacional. Retorna um inteiro; timezone define o limite do dia da semana e tem UTC como padrão (passe Asia/Shanghai para dados baseados na China).
| Categoria | Data |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $isoDayOfWeek: { date: <expressão de data>, timezone: <fuso horário> } }
⚙️ Parâmetros
| date | Obrigatório; a expressão de data. |
|---|---|
| timezone | Fuso horário opcional; o padrão é UTC. |
Retorno:Dia da semana ISO (1=segunda, 7=domingo); null se date for null.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $isoDayOfWeek: vendas por dia da semana ISO (horário de Pequim)
db.sales.aggregate([
{ $group: {
_id: { $isoDayOfWeek: { date: '$soldAt', timezone: 'Asia/Shanghai' } },
total: { $sum: '$amount' }
} }
])
Saída:
{ "_id": 1, "total": 3200 }
{ "_id": 2, "total": 2750 }
📌 Notas
- Difere por um de $dayOfWeek: segunda-feira é 2 lá, 1 aqui
- Geralmente combinado com $isoWeek e $isoWeekYear
- O padrão é UTC — unifique o fuso horário antes das estatísticas
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
Q1 é segunda-feira ou domingo?
AConforme ISO 8601: 1 é segunda-feira, 7 é domingo.
QQual é a distância para $dayOfWeek?
AA mesma data difere por um: o 2 de $dayOfWeek equivale ao 1 de $isoDayOfWeek.
QO fuso horário muda o dia da semana?
ASim — horários próximos da meia-noite podem virar outro dia; unifique o fuso horário.