$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).

CategoriaData
Versão do MongoDB1.0+
Idioma do Exemplomongosh (Shell)

📝 Sintaxe

{ $isoDayOfWeek: { date: <expressão de data>, timezone: <fuso horário> } }

⚙️ Parâmetros

dateObrigatório; a expressão de data.
timezoneFuso 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

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.
Web-Tutorial.com

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.

100%