ForHosting KIT · Ferramentas para dev

Dias restantes no mês

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.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

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. 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. 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. Por isso, um navegador em Tóquio e uma execução da API em UTC concordam para a mesma data ISO. Essa consistência é particularmente útil perto da meia-noite local. 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. 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.

Quanto custa uma solicitação de API?

Cada solicitação de API usa o preço-base publicado de US$ 0,002.

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

POSThttps://api.kit.forhosting.com/date/days-remaining-month

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

por chamadaUS$ 0,002

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.

Ver a documentação completa do KIT →