Dias restantes no mês
A partir de 20 de fevereiro de 2024, faltam 9 dias até o mês terminar, em 29 de fevereiro. Digite uma data e receba os dias restantes, o último dia do mês e a duração do mês. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data
- 2024-02-20
- Fim do mês
- 2024-02-29
- Dias do mês
- 29
- Dias restantes
- 9
A calculadora de dias restantes no mês recebe uma data de calendário ISO explícita e mede quantas viradas completas de dia existem entre essa data e o último dia do mesmo mês. Ela não consulta o horário atual, não presume que a data seja hoje nem depende do fuso horário do dispositivo. Assim, o resultado é reproduzível em agendas, relatórios, testes e fluxos de dados. A resposta também informa a data final e a quantidade de dias do mês para você conferir o cálculo imediatamente.
Informe uma data exata do calendário
Envie a data como texto no formato exato AAAA-MM-DD, incluindo zeros à esquerda em meses e dias de um só algarismo. Uma data no início de abril, por exemplo, ainda precisa ter dois dígitos nos dois componentes. A calculadora aceita anos do calendário gregoriano de 0001 a 9999 e verifica se os componentes formam uma data real.
Ela rejeita o mês zero, o mês treze, dias além da duração do mês e 29 de fevereiro em anos que não são bissextos. Esse contrato rigoroso impede que formatos regionais ambíguos, com mês ou dia primeiro, mudem o sentido do cálculo. A entrada deve ser explícita: expressões como hoje ou amanhã não são aceitas, pois exigiriam consultar o relógio e poderiam gerar outra resposta depois.
Após a validação, a saída preserva o texto ISO canônico enviado, facilitando a associação com o registro de origem. Uma entrada inválida gera um erro de cliente tipado, sem estimativas ou correções silenciosas.
Entenda o significado da contagem
O resultado conta os dias completos entre a data informada e a última data civil do mesmo mês. A fórmula subtrai o número do dia da quantidade de dias daquele mês. Por essa definição, o último dia retorna zero, pois não resta nenhuma virada completa antes do encerramento mensal.
O dia anterior retorna um. A data inicial não entra como mais um dia restante: o valor representa uma duração, e não uma contagem inclusiva de datas. Fevereiro segue a regra gregoriana: anos divisíveis por quatro são bissextos, exceto os anos de século que não sejam também divisíveis por quatrocentos.
Abril, junho, setembro e novembro têm trinta dias; os demais, fora fevereiro, têm trinta e um. Não há aproximação, média de duração mensal nem conversão de carimbo de data e hora.
Use resultados determinísticos na automação
Esta capacidade atende sistemas que já possuem uma data e precisam de um intervalo estável até o fim do mês. Um fluxo de faturamento pode calcular os dias completos restantes no período para cada registro datado. Um relatório de projeto pode exibir uma contagem regressiva baseada em sua data de referência, sem trocá-la acidentalmente pelo dia em que o arquivo foi aberto.
Uma suíte de testes pode manter valores esperados porque a mesma entrada sempre produz a mesma saída. O algoritmo usa apenas aritmética inteira de calendário. Ele não acessa serviços externos, não gera valores aleatórios, não cria objetos Date, não verifica o fuso do sistema e não lê o relógio atual.
Essa consistência é particularmente útil perto da meia-noite local. Para dias úteis, feriados, contagem inclusiva ou datas em meses diferentes, use uma capacidade cujo contrato modele essas regras.
Casos de uso
Preparar um relatório mensal
Inclua um intervalo reproduzível usando a data do próprio relatório, não o dia em que alguém o abre.
Testar cortes de faturamento
Monte casos estáveis para meses comuns, fevereiro bissexto e limites mensais sem simular o relógio do sistema.
Enriquecer registros datados
Anexe a data final, a duração do mês e os dias completos restantes a cada registro do fluxo.
Perguntas frequentes
A contagem inclui a data informada?
Não. Ela mede viradas completas de dia até o fim do mês. O último dia retorna zero e o anterior retorna um.
A ferramenta usa a data de hoje?
Não. Você precisa fornecer uma data explícita, e o relógio atual nunca é consultado.
Como fevereiro é tratado?
A regra gregoriana define se fevereiro tem vinte e oito ou vinte e nove dias, incluindo as exceções de séculos e quatrocentos anos.
O fuso horário pode mudar o resultado?
Não. O cálculo usa componentes de calendário e aritmética inteira, sem objetos Date nem conversões de horário.
Qual resultado aparece no último dia do mês?
Zero, porque não sobra nenhum dia inteiro antes de o mês acabar. O penúltimo dia dá 1, então o resultado é uma duração, e não uma contagem de datas.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/date/days-remaining-month \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-02-20"}'const res = await fetch("https://api.kit.forhosting.com/date/days-remaining-month", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-02-20"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/days-remaining-month",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-02-20"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/days-remaining-month", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-02-20"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-02-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-remaining-month", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"date": "2024-02-20"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.days_remaining_month",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Entenda o significado da contagem
Além de days_remaining, a saída contém month_end e days_in_month. Esses campos revelam os dados usados na subtração e permitem conferir o resultado.
Use resultados determinísticos na automação
Por isso, um navegador em Tóquio e uma execução da API em UTC concordam para a mesma data ISO. Cada solicitação de API usa o preço-base publicado de US$ 0,002; no navegador, o mesmo cálculo puro pode ser executado localmente.
Perguntas técnicas
Quanto custa uma solicitação de API?
Cada solicitação de API usa o preço-base publicado de US$ 0,002.