Como calcular dias, datas e semanas ISO

Distinguir intervalos, dias úteis e fusos horários antes de interpretar um resultado de data.

Guia práticoAtualizado Tempo estimado de leitura: 3 min
Nesta página

Distinguir os dias decorridos a partir das datas incluídas

Dias entre datas subtrai a data de início da data de término. 1 de janeiro a 2 de janeiro é um dia decorrido, enquanto contar ambas as datas do calendário dá dois. Estabeleça qual pergunta você precisa responder antes de usar um total. Um intervalo não é automaticamente o número de datas incluídas em um cronograma.

Adicionar dias muda uma data de calendário por um inteiro: dez dias após 1o de janeiro é 11 de janeiro e valores negativos subtraim dias. Essas ferramentas calculam datas de calendário usando UTC para evitar diferenças causadas por mudanças de relógio. Eles não calculam as horas de trabalho ou interpretam as regras especiais de um calendário específico.

Contar dias úteis com exclusões explícitas

Dias úteis tratam sábado e domingo como fins de semana. Ele inclui a data de início e permite que você inclua ou exclua a data de término. Digite feriados no formato YYYY-MM-DD, um por linha. Nenhum calendário oficial é baixado, então você deve fornecer as exclusões relevantes para sua tarefa.

Feriados repetidos são deduzidos uma vez, e feriados caindo nos fins de semana não são deduzidos novamente. Teste uma semana conhecida com um dia da semana excluído para verificar o comportamento. Se sua atividade funcionar aos sábados ou seguir outro padrão de fim de semana, esse modelo não representa esse calendário. Verifique a convenção antes de aplicar o total a um plano ou cronograma real.

Interpretar semanas ISO e timestamps

Relatórios da semana ISO ano, semana e dia da semana. Semanas começam na segunda-feira e a primeira semana contém a primeira quinta-feira do ano. Perto de janeiro e dezembro, o ano ISO pode ser diferente do ano civil. 1o de janeiro de 2021 é 2020-W53-5: Sexta-feira do ano ISO 2020 da semana 53.

Um carimbo de data/hora Unix representa um instante e não apenas uma data de calendário. Selecione segundos ou milissegundos e inclua Z ou um deslocamento como +02:00 ao inserir uma data e hora. A saída está em UTC. Diferentes leituras de relógio local podem representar o mesmo instante quando as compensações diferem, então preserve a compensação em seus registros de origem.

Teste os limites e documente a convenção

Tente um intervalo de data única, um fim de semana e um intervalo com o fim excluído. Registre se as medidas de resposta decorrido dias ou datas incluídas. Para datas fictícias, o gerador aleatório inclui os dois terminais e pode evitar repetições quando houver datas suficientes disponíveis dentro do intervalo selecionado.

Datas aleatórias não são filtradas para dias úteis ou feriados. Uma lista de testes pode conter sábados, domingos e fechamentos que sua atividade exclui. Mantenha a convenção ao lado do resultado e verifique o formato e as unidades antes de copiar para outro aplicativo. Para um calendário específico, valide independentemente suas regras e as datas de exclusão que você forneceu, em vez de tratar um cálculo de data geral como autoridade desse calendário.

EXPERIMENTE

Uma semana com um fechamento

Digite essas datas em dias úteis. A exclusão é fictícia para este julgamento e não representa um calendário oficial de férias. Calcule com o fim incluído, então exclua-o para observar a convenção de contagem.

Start: 2026-10-12
End: 2026-10-16
Sample exclusion: 2026-10-14
Include end date: yes

Incluindo o final dá cinco datas e quatro dias úteis após a exclusão de quarta-feira. Excluindo sexta-feira dá quatro datas e três dias úteis.

Dias entre datas dão quatro dias decorridos para esse intervalo. Relatórios da semana ISO 2020-W53-5 para 2021-01-01. Compare significado e números antes de escolher qual resultado responde sua pergunta.