Dias entre duas datas

O que significa um intervalo de dias inteiros e o que a resposta contém

Contar dias inteiros de calendário entre duas datas responde a uma pergunta diferente de contagens de dias úteis, idade em anos e meses, ou subtração de timestamps com fuso horário: mede a distância civil pura no calendário gregoriano, de meia-noite a meia-noite, sem pular fins de semana, feriados ou transições de horário de verão. Se você precisa de dias úteis, navegação de subtração de dias, conversão de epoch ou análise de múltiplos formatos, use essas ferramentas dedicadas; esta página responde apenas à distância gregoriana em dias inteiros entre duas datas ISO validadas. Você informa uma data de início e uma data de fim como strings estritas AAAA-MM-DD; a ordem não precisa ser cronológica, porque o campo days absoluto é sempre não negativo, enquanto signed_days preserva a direção quando o fim é anterior ao início. A calculadora valida que os dois dias são dias reais de calendário — 29 de fevereiro apenas em anos bissextos, trinta dias em abril, nunca dia trinta e dois — e então retorna as strings de início e fim normalizadas, days como a distância absoluta em dias inteiros, signed_days como o serial de fim menos o serial de início, os campos de componente start_year, start_month, start_day, end_year, end_month e end_day para facilitar o encadeamento com outras ferramentas, e um breve lembrete de fórmula. Os casos rejeitados incluem campo start ou end ausente, formatos errados como 2024/01/01, meses impossíveis, dias que não existem como 2023-02-29, e anos fora do intervalo de um a 9999.

Como start e end são interpretados e como a contagem permanece reproduzível

Cada string deve corresponder a quatro dígitos, um hífen, dois dígitos, outro hífen e dois dígitos; espaços no início ou no fim são removidos, mas datas parciais, apenas o dia ordinal do ano, nomes de meses e horários embutidos não são expandidos aqui. Depois da análise, cada ano deve estar entre 1 e 9999, cada mês entre 1 e 12, e cada dia entre 1 e o comprimento real desse mês naquele ano, com anos bissextos seguindo a regra gregoriana de divisível por quatro, exceto anos de século não divisíveis por quatrocentos. O primeiro campo preferido é start, mas os aliases from, date1, a e begin são aceitos, para que planilhas, strings de consulta e formulários tipados possam reutilizar o mesmo contrato sem renomear colunas. O segundo campo preferido é end, com os aliases to, date2, b e finish pelo mesmo motivo. Internamente, o mecanismo converte cada tripla civil em uma contagem serial prolética gregoriana de dias usando o conhecido mapeamento days_from_civil, subtrai o serial de início do serial de fim para obter signed_days, e então toma o valor absoluto para days — aritmética inteira pura, estável bit a bit entre runtimes. Datas idênticas resultam em zero; inverter o par apenas troca o sinal de signed_days e deixa days inalterado. Combine a execução gratuita no navegador desta página com a API paga quando precisar do mesmo intervalo de dias dentro de um pipeline automatizado.

Onde a aritmética de intervalo de dias se encaixa em planejamento, cobrança e software

Nesta página o trabalho roda inteiramente no seu navegador; pela API, cada consulta bem-sucedida custa US$ 0,002, a validação com falha não é cobrada, e nada é armazenado depois que a resposta é devolvida. Essa divisão — exploração interativa gratuita e uma API paga e idêntica — segue o padrão do resto do catálogo tier A do KIT e permite passar de uma verificação pontual para um pipeline sem mudar o resultado matemático.