Primeiro Dia Da Semana

A configuração de primeiro dia da semana que ninguém te explica direito

Se você já tentou gerar um relatório de segunda a domingo e ele saiu virado, provavelmente esbarrou nisso. A maioria dos sistemas trata o domingo como início da semana por padrão. Não é um bug, é uma escolha de herança que vem do Excel e de padrões americanos antigos. O problema é que quem mora fora desse padrão precisa lidar com conversões manuais o tempo todo.

Por que o primeiro dia da semana importa na prática

Configurar o primeiro dia da semana corretamente afeta desde a exibição de um calendário simples até o cálculo de semanas ISO, relatórios de RH e processamento de lotes automatizados. Se a configuração estiver errada, uma planilha que supostamente cobre "a semana passada" pode pegar uma quarta-feira e ir até uma terça, porque o sistema considerou domingo como começo. Dados que deveriam ser agrupados ficam fragmentados entre semanas. Relatórios de vendas que cruzam meses ficam incompletos. E quando o erro é em lote de integração, você não percebe no momento da execução — só vê dias depois, quando a reconciliação financeira não fecha.

Um exemplo real que eu tive

Eu configurei um sistema de controle de escalas para uma clínica que opera de segunda a sábado. O desenvolvedor que fez a interface usou a biblioteca padrão do navegador com a configuração inicial do JavaScript, que retorna Domingo como primeiro dia da semana em muitos ambientes. Quando testamos o relatório semanal, a primeira semana do mês vinha cortada: o dia 1 de agosto caía numa quarta, mas o relatório exibia de domingo anterior até segunda, misturando dias de julho com os de agosto. O relatório de faturamento daquela "semana" ia para um período que não correspondia a nenhum contrato. O conserto foi explícito: defini a propriedade de início da semana como Segunda manualmente em todos os componentes que renderizavam calendário e em todas as consultas que montavam o intervalo de datas. Se você está usando React com uma biblioteca de calendário, a prop correta geralmente se chama startOfWeek ou firstDayOfWeek. Se for uma query SQL, depende do banco: no MySQL existe a variável week_format, no PostgreSQL costuma-se usar DATE_TRUNC com ajuste manual ou a função ISOWEEK. No Excel, isso fica na seção Opções Avançadas da guia Fórmulas. Cada plataforma tem seu próprio jeitinho.

Como definir o primeiro dia da semana em ferramentas comuns

Vou listar os cenários mais frequentes, direto ao ponto.

JavaScript e bibliotecas de data

O Date.prototype.getDay() retorna 0 para Domingo e 6 para Sábado. Isso é fixo na linguagem e não muda com locale. Se você quer trabalhar com a semana começando na Segunda, tem duas opções. A primeira é criar um helper que faz weekStart(date) subtraindo os dias necessários: const weekStart = date => { const d = new Date(date); const day = d.getDay(); const diff = (day === 0 ? -6 : 1 - day); d.setDate(d.getDate() + diff); d.setHours(0,0,0,0); return d; }; A segunda é usar uma biblioteca. O Day.js tem a opção locale com firstDayOfWeek. O date-fns tem startOfWeek com { weekStartsOn: 1 }. O Luxon também permite configurar pelo locale. Se você precisar de ISO week number, o date-fns oferece startOfISOWeek, que sempre devolve Segunda, independente da configuração local.

Python com pandas e datetime

O pandas lida com isso de forma elegante. Na leitura de um CSV, você pode forçar o índice de datas e usar freq='W-MON' para fechar semanas em Segunda. Um dataframe.resample('W-MON').sum() vai agrupar tudo pela Segunda como início. Se estiver usando datetime puro, a lógica é parecida com a do JavaScript, mas você usa timedelta. A grande vantagem do pandas é que você não precisa reinventar a rodinha para intervalos e agregações. Se tiver dados com fuso horário misturado, use tz_localize e tz_convert antes de fazer o resampling, senão o agrupamento fica com horas duplicadas ou faltando.

SQL: diferenças entre bancos

No MySQL, a função WEEK(date, mode) usa o modo para definir o início da semana. Modo 0 começa em Domingo, modo 1 em Segunda. Use sempre o modo 1 se quiser conformidade com o padrão europeu. No PostgreSQL, não há uma função WEEK que siga ISO automaticamente sem ajuste. O mais seguro é usar EXTRACT(ISOYEAR FROM date) junto com EXTRACT(ISOWEEK FROM date), que seguem a norma ISO 8601 e consideram Segunda como início. Se precisar de BETWEEN com datas de semana, calcule start_date = date_trunc('week', target_date) - 1 dia, porque date_trunc('week') no PostgreSQL retorna Domingo, não Segunda. Confuso? Sim. Por isso eu sempre uso ISOWEEK quando possível.

Excel e Google Sheets

No Excel, a função =TEXTO(data;"AAAA-WW") usa a numeração de semana baseada na regra de que a semana 1 é a que contém o primeiro giovedì do ano, que segue a norma ISO. Porém, se você montou tabelas dinâmicas com intervalos fixos de 7 dias a partir de uma data arbitrária, aí você controla o início manualmente. Para mudar o padrão da pasta de trabalho, vá em Arquivo > Opções > Avançado > Opções de edição e mude "Primeiro dia da semana" para Segunda. Isso afeta a exibição, não os cálculos. No Google Sheets, a função =TEXT(A1,"YYYY-WW") segue padrão ISO, então costuma funcionar sem ajuste. Mas se estiver usando QUERY com filtros de data, defina o intervalo explicitamente com DATE(YEAR(A1),MONTH(A1),DAY(A1))-WEEKDAY(A1,2)+1 para começar na Segunda.

Pegadinhas que custaram horas do meu dia

Aqui estão os problemas mais chatos que eu encontrei e que raramente aparecem em tutoriais básicos. : Quando o ano novo cai numa quarta-feira, a semana 01 ISO começa no último sábado do ano anterior. Se seu sistema simplesmente corta por número da semana sem checar o ano ISO, você vai juntar dados de dezembro com janeiro. Sempre use o par ISOYEAR-ISOWEEK, nunca só ISOWEEK isoladamente.

Fuso horário em aggregations: Se seus registros têm timestamp com UTC e você agrupa por semana em horário local, um mesmo registro pode cair em semanas diferentes dependendo do fuso do servidor. O correto é normalizar tudo para UTC antes de agrupar, ou aplicar a conversão de fuso antes do truncamento. Eu já vi dados de vendas de um evento noturno serem distribuídos entre duas semanas só porque o servidor estava num fuso adiantado e a meia-noite local transbordava para o dia seguinte no UTC. Bibliotecas que mudam de versão: A versão 2 do date-fns alterou o comportamento padrão de startOfWeek em algumas combinações de locale. Atualizei uma dependência e um relatório que havia funcionado por dois anos passou a reportar semanas deslocadas. Sempre versionoe as bibliotecas de data com cuidado e teste a regressão em todas as janelas de agregação críticas.

Locale inconsistente: Definir locale pt-BR não garante que o primeiro dia da semana seja Segunda. Em algumas configurações do sistema operacional, o pt-BR ainda herda Domingo como início por causa da cultura americana dos pacotes de idioma. Verifique isso com um print de startOfWeek(new Date()) antes de confiar na configuração.

Quando usar ISO week versus semana cultural

A norma ISO 8601 define a semana como começando na Segunda e atribui a semana 01 como aquela que contém o primeiro giovedì do ano. Isso é bom para padronização internacional, mas não reflete a realidade cultural de muitos países. No Brasil, por exemplo, o comércio e os órgãos públicos costumam usar Domingo como referência para relatórios semanais. Se você está construindo algo para o mercado brasileiro, pergunte ao cliente qual convenção ele espera. Se for para um relatório de ponto, a lei exige domingo a sábado em muitos casos. Se for para logística e fretes, a Segunda faz mais sentido porque o ciclo operacional das transportadoras costuma começar nesse dia. Não existe resposta universal, e tentar forçar ISO onde o negócio não usa ISO só gera retrabalho.

Resumo rápido do que funciona

• Defina explicitamente o início da semana em cada camada do sistema. Não confie no padrão.
• Use ISOYEAR + ISOWEEK quando precisar de estabilidade year-boundary.
• Normalize fuso horário antes de agrupar por semana.
• Teste ano novo e finais de mês com datas que cruzam semanas de forma irregular.
• Verifique a versão da biblioteca de data após qualquer atualização.
• Confirme com o usuário final qual convenção cultural se aplica ao contexto dele.

Se você está começando agora e quer algo prático, o caminho mais seguro é usar date-fns com startOfISOWeek e endOfISOWeek, somado a uma normalização de timezone para UTC nas ingressões. Para relatórios internos no Brasil, considere criar uma small helper que respeite Domingo como início, mas deixe claro nos metadados do sistema qual convenção foi adotada. Documentação ruim custa mais do que configuração correta.

primeiro dia da semana no dia a dia

No final das contas, configurar o primeiro dia da semana é menos sobre escolher entre Segunda e Domingo e mais sobre garantir que todos os sistemas da sua stack estejam falando a mesma língua. Quando a planilha diz uma coisa, o banco diz outra e a API de frontend traduz diferente, o relatório que parece simples vira um quebra-cabeça. A solução não é complicated — é ser explícito em cada camada e validar com dados reais que cruzem semanas e anos. Depois disso, você gasta menos tempo corrigindo semanas erradas e mais tempo resolvendo o problema que realmente importa.