Calculadora de número da semana

"Vamos entregar na W38" é uma frase sem ambiguidade — desde que todo mundo concorde sobre qual semana é essa. A ferramenta acima mostra o número da semana ISO 8601 de qualquer data, junto com o ano ISO, que nem sempre é o ano civil.

Como funciona

Escolha uma data; o padrão é hoje. O resultado traz o número da semana ISO e o ano ISO, e o botão de copiar gera a forma combinada padrão, 2026-W38.

A ISO 8601 define a semana com precisão:

• As semanas vão de segunda a domingo. Segunda-feira é o dia 1 e domingo, o dia 7.
• A semana 1 é a que contém a primeira quinta-feira do ano — ou seja, a que contém o dia 4 de janeiro, ou ainda a primeira semana com a maioria dos dias no ano novo.
• Um ano tem 52 ou 53 semanas ISO. Anos de 53 semanas aparecem mais ou menos a cada cinco ou seis anos, quando 1º de janeiro cai numa quinta-feira, ou numa quarta-feira em ano bissexto.

A consequência interessante está na virada do ano. 31 de dezembro de 2025 cai na semana ISO 1 do ano ISO 2026; 1º de janeiro de 2027 cai na semana 53 do ano ISO 2026. É por isso que a ferramenta mostra o ano ISO como um número separado, em vez de assumir o ano civil da data que você digitou: um número de semana sem o ano ISO fica ambíguo durante uns seis dias por ano, e são exatamente os dias em que acontecem os fechamentos de fim de ano.

As datas são interpretadas como meia-noite no horário local e a aritmética das semanas é feita depois em UTC, então a resposta nunca muda um dia por causa do seu fuso horário.

Semanas ISO não são a única convenção

Isso importa se você compara números entre sistemas diferentes. Há outras duas convenções bastante usadas:

• As semanas americanas (ou "broadcast") vão de domingo a sábado, e a semana 1 é simplesmente a que contém 1º de janeiro. Por isso, na maioria dos anos o número da semana americana é uma unidade maior que o ISO no começo de janeiro, e os dois podem divergir nas primeiras semanas do ano.
• As semanas ordinais simples só contam blocos de sete dias a partir de 1º de janeiro, o que produz uma "semana 53" residual de um ou dois dias e nenhum alinhamento estável com os dias da semana.

As planilhas ficam em cima do muro: o WEEKNUM do Excel (NÚMSEMANA em português) usa por padrão a convenção americana e precisa de ISOWEEKNUM (ou WEEKNUM(date, 21)) para a ISO. Se um dashboard e uma planilha divergem em uma unidade, quase sempre o motivo é esse.

Trabalhando com semanas no código e nos dados

Não calcule números de semana com dayOfYear / 7. Use o suporte a ISO da plataforma: WeekFields.ISO no java.time, %G-W%V no strftime, EXTRACT(ISOYEAR ...) e EXTRACT(WEEK ...) no PostgreSQL. Optional e a API de data e hora apresenta os campos temporais e os ajustadores que transformam isso numa linha de código, e não numa fonte de bugs na virada do ano.

A semana também é a granularidade de relatório mais comum, e é aí que o ano de 53 semanas cobra seu preço: uma comparação ano a ano "da semana 1 à semana 52" descarta uma semana de dados sem avisar, e um gráfico indexado por ano civil mais número da semana vai contar duas vezes ou perder a semana da virada. Indexar pelo par ano ISO–semana resolve os dois problemas. Business intelligence explica como escolher a granularidade temporal e montar uma dimensão de data que traga semana ISO e ano ISO como colunas próprias, que é a solução duradoura.

Ferramentas relacionadas

Para contar os dias entre duas datas, use dias entre datas; para excluir os fins de semana, dias úteis; para uma contagem regressiva até um marco fixo, dias até uma data.