Calculadora de contagem de dias

dias entre as datas = número de meias-noites atravessadas da data inicial até a data final; dias incluindo as duas pontas = esse número + 1, contando cada ponta como um dia inteiro

startDate

A primeira das duas datas, escrita como AAAA-MM-DD. Qual delas é a mais antiga não importa — a ordem pode ser trocada à vontade

endDate

A segunda data. Ela não precisa vir depois da primeira, e a resposta é idêntica nos dois sentidos

includeEndDate

A caixa de seleção que escolhe a convenção: desmarcada, conta os dias entre as duas datas; marcada, conta também as duas pontas. Ela muda apenas o número principal — as outras duas linhas aparecem sempre

totalDays

A contagem principal, seguindo a caixa de seleção. É o mesmo número de uma das duas linhas abaixo dela, nunca uma terceira resposta

inclusiveDays

A contagem com o primeiro e o último dia incluídos, do jeito que uma lista de presença ou um tratamento conta os dias

exclusiveDays

A contagem dos dias estritamente entre as duas datas, do jeito que um hotel conta noites ou uma locação conta diárias

Use quando um erro de um dia fosse parecer erro no papel: uma diária de hotel cobrada por noite, um período de locação, um tratamento que vai do primeiro ao sétimo dia, um pedido de férias, um período de experiência ou de aviso prévio, ou um projeto cobrado por dia. As duas contagens diferem exatamente em um dia, então vale escrever qual delas o número deve ser antes de citá-lo; a caixa de seleção existe justamente para deixar as duas leituras visíveis em vez de pressupostas. Se o que você precisa é incluir o dia final numa contagem, marque a caixa e leia a linha que inclui as duas datas. Para uma decomposição em anos, meses e dias, ou para uma contagem que pula fins de semana e feriados, existe outra página; esta aqui conta todos os dias corridos do intervalo.

1. Três noites de sexta a segunda

   1. Ir de sexta, 2 de janeiro, a segunda, 5 de janeiro, atravessa três meias-noites: as que começam no sábado, no domingo e na segunda
   2. Contado entre as datas, isso dá 3 dias — o número de noites, e o número que um hotel ou um contrato de locação usa
   3. Contado com as duas pontas como dias, dá 3 + 1 = 4 dias, que é o que uma lista de presença ou um pedido de férias costuma querer dizer
   4. Aqui a caixa está desmarcada, então o número principal lê 3 enquanto a linha que inclui as duas datas continua mostrando 4

   Os dois números descrevem a mesma estadia; nenhum deles é um arredondamento do outro. Essa diferença de um dia é a razão inteira de esta página existir em vez de uma única diferença entre datas, e a descrição de uma reserva vai usar a convenção que o estabelecimento escolheu.

2. A mesma data digitada duas vezes

   1. Nenhuma meia-noite cai entre as duas datas, então os dias entre elas são 0
   2. Com as duas pontas contadas dá 0 + 1 = 1: a própria data é um dia no calendário
   3. A caixa está marcada, então o número principal segue a leitura que inclui as duas datas e mostra 1
   4. Desmarque a caixa e o número principal passa a 0 sem que nenhuma das duas linhas abaixo dele mude

   É o máximo que as duas convenções chegam a se afastar em proporção: 0 e 1. É também o caso que uma diferença entre datas sozinha não consegue expressar, porque ela não tem como dizer se a própria data conta.

3. Atravessando o dia bissexto

   1. 2024 é um ano bissexto, então o 29 de fevereiro existe e fica entre as duas datas
   2. Dias entre as duas: o 29 de fevereiro está no meio e precisa ser atravessado, então há duas meias-noites no caminho e a contagem é 2
   3. Somando as duas pontas dá 3 dias, e como a caixa está desmarcada o número principal lê 2
   4. O mesmo par de datas num ano comum, como 2026, dá 1 dia, porque não há 29 de fevereiro para atravessar

   O dia bissexto não recebe tratamento especial em lugar nenhum: 29 de fevereiro é simplesmente uma data como qualquer outra, e a contagem segue o calendário. Vale a pena digitar este par uma vez num ano bissexto e outra num ano comum para ver que a resposta é do calendário, e não de uma regra fixa.

O resultado é uma contagem de dias inteiros de calendário, então uma fração de dia nunca aparece: das 9h de uma data às 9h da data seguinte é um dia, e das 23h à 1h também, porque só as datas são lidas e o horário não é informado em lugar nenhum. Todos os dias do intervalo entram na conta, fins de semana e feriados inclusive — uma contagem de dias úteis é outra pergunta, com outra resposta. Não há decomposição em anos, meses e semanas, apenas as duas contagens de dias. As datas precisam existir: 30 de fevereiro é recusado em vez de ser empurrado para 1 de março. A faixa aceita vai de 1 de janeiro do ano 1 a 31 de dezembro do ano 9999, e as duas datas podem ser digitadas em qualquer ordem sem mudança no resultado. Vale registrar que as linhas que incluem as duas datas e a que exclui a data final aparecem sempre, qualquer que seja a posição da caixa de seleção: ela não esconde nem recalcula essas duas, só decide qual delas o número principal repete.

Qual dos dois números eu devo usar?

O que combina com o que está sendo contado. Use os dias entre as datas quando cada dia for uma noite, uma diária de locação ou um período de 24 horas que começa na data inicial — uma estadia de sexta a segunda são três noites. Use a contagem que inclui as duas datas quando a própria data inicial já for o dia um, como num tratamento, numa lista de presença ou num pedido de férias. As duas diferem exatamente em um dia, então citar a errada é um erro visível, e esta página mostra as duas para que a escolha possa ser conferida em vez de pressuposta.

Quantos dias tem o mês de janeiro?

Trinta e um, contando do dia 1 ao dia 31 com as duas pontas incluídas, e trinta contando os dias entre elas. Informe 1 de janeiro e 31 de janeiro: com a caixa marcada o número principal lê 31, e com ela desmarcada o número principal lê 30 enquanto a linha que inclui as duas datas continua mostrando 31. O comprimento do mês não é um caso especial aqui — qualquer par do primeiro ao último dia funciona do mesmo jeito.

Eu conto o primeiro dia, o último dia, ou nenhum dos dois?

É exatamente isso que a caixa de seleção decide, e as duas convenções são usadas no dia a dia. A contagem entre as datas não trata nenhuma das pontas como um dia próprio, que é como um hotel conta noites; a contagem que inclui as duas pontas trata as duas, que é como um tratamento do dia 1 ao dia 7 dura sete dias. Como as duas leituras são calculadas, marcar e desmarcar a caixa nunca altera as duas linhas abaixo do número principal — só qual delas ele repete.

O que acontece se eu trocar as duas datas de lugar?

Nada. Um intervalo é uma distância, então a contagem é a mesma qualquer que seja a data digitada primeiro, e não existe resposta negativa com que se preocupar. Informar 5 de janeiro como início e 2 de janeiro como término dá exatamente os mesmos números que a outra ordem dá. A ordem importa apenas na frase que descreve o resultado — em que dia uma estadia começou é uma pergunta diferente de quantas noites ela durou.

Isto é a mesma coisa que uma calculadora de datas?

Não, e a diferença está no que sai. Uma calculadora de datas decompõe um intervalo em anos, meses e dias — o quão distantes duas datas estão em termos de calendário. Esta página responde quantos dias o intervalo cobre, sob uma de duas convenções, e deixa a decomposição de fora de propósito, para que o mesmo número não seja publicado em duas páginas. Para uma contagem que pula fins de semana e feriados, a página é a calculadora de dias úteis, que devolve um número menor que este.

• Federal Rules of Civil Procedure, Rule 6 — Computing and Extending Time — Legal Information Institute, Cornell Law School
• Calendar FAQ — The Gregorian Calendar — Claus Tøndering, Calendar FAQ
• RFC 3339: Date and Time on the Internet: Timestamps — IETF