Número da semana ISO

Número da semana ISOUsos e orientação prática

Uma data da semana ISO identifica um dia durante a semana ano, número da semana e dia da semana. Semanas começam na segunda-feira, numeradas 1, e terminam no domingo, numeradas 7. Semana 1 contém a primeira quinta-feira do ano. Esta regra usa semanas completas de segunda a domingo sem dividi-las artificialmente em um ano. A ferramenta exibe um rótulo como 2020-W53-5 e apresenta seus componentes separadamente para inspeção ou transferência para outro documento. Mantenha esses componentes juntos quando o rótulo de data da semana estiver sendo usado para identificar um dia específico, em vez de simplesmente agrupar registros.

O ano da semana pode ser diferente do ano mostrado na data normal do calendário. Sexta-feira 1 de janeiro de 2021 pertence à semana 53 do ano ISO 2020. Pela mesma razão, algumas datas finais de dezembro pertencem à semana 1 do ano seguinte da ISO. Dividir o dia do ano por sete é insuficiente, como é contar a partir de 1o de janeiro como se fosse sempre segunda-feira. Inspecione o ano da semana ao lado do número da semana quando agrupar relatórios: combinar o ano civil com um número da semana ISO pode produzir um par incorreto. A distinção importa especialmente em conjuntos de dados contendo os últimos e primeiros dias de anos adjacentes.

Dia do ano é uma medida separada calculada dentro do ano civil original. O 1o de janeiro sempre tem ordinal 1, mesmo quando pertence a uma semana no ano ISO anterior. Os anos bissextos incluem 29 de fevereiro e podem chegar ao dia 366. O cálculo usa datas do calendário UTC sem uma hora do dia, impedindo que as mudanças de relógio sazonais adicionem ou subtraiam frações de um dia. Os fusos horários não são convertidos e uma data local não é inferida a partir de um carimbo de data e hora completo. Insira a data do calendário apropriada ao seu contexto antes de procurar os componentes da semana.

Esta interface usa regras ISO ao invés de convenções regionais onde as semanas começam no domingo ou as primeiras datas de janeiro sempre pertencem à semana 1. As aplicações podem exibir números de semana diferentes quando suas convenções diferem sem interpretar mal a data fornecida. Confirme as regras de destino antes de combinar listas. Datas de calendário válidas entre os anos 0001 e 9999 são suportadas; datas inexistentes como 30 de fevereiro são rejeitadas. Tente uma data de início de janeiro, uma data de fim de dezembro e um dia bissexto para revisar o comportamento de fronteira. Salve o rótulo completo da data da semana quando um dia deve ser identificado sem ambiguidade em vez de reter apenas um número de semana sem o ano associado e o dia da semana.