Fração do mês decorrida
Em 15 de fevereiro de 2024 já passaram 15 dos 29 dias do mês, pouco mais da metade, e faltam 14. Digite qualquer data e receba a fração e a porcentagem decorridas do mês, prontas para rateios, ciclos de cobrança e barras de progresso. 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-15
- Ano
- 2.024
- Mês
- 2
- Dia
- 15
- Nome do mês
- February
A fração de um mês que já decorreu em uma data civil dada é a parte daquele mês de calendário que ficou para trás, expressa tanto como intervalo unitário desde logo acima de zero no primeiro dia do mês até um no último, quanto como percentual desde logo acima de zero até cem. Ciclos de cobrança, rateio de aluguel, crédito de assinatura, cortes de folha e barras mensais de OKR precisam desse número sem lutar com fusos do host nem tabelas de horário de verão. Esta calculadora aceita uma única data de calendário ISO na forma estrita ano-mês-dia com quatro, dois e dois dígitos, verifica se o dia realmente existe no calendário gregoriano —incluindo fevereiros bissextos—, consulta quantos dias aquele mês contém e devolve a fração decorrida como o dia do mês dividido pelo comprimento do mês mais o percentual correspondente. Datas impossíveis como 29 de fevereiro em um ano comum ou 31 de abril falham com um erro de validação claro em vez de um ajuste silencioso.
Como a fração decorrida de um mês é calculada a partir de uma data ISO
Comece com uma data civil escrita como ano, mês e dia na forma ISO internacional com hífens e larguras fixas para que todo cliente concorde com os mesmos três inteiros. Primeiro confirme que o ano está em um intervalo gregoriano prático do ano um até nove mil novecentos e noventa e nove e que o mês está entre um e doze.
Em seguida aplique a regra bissexta usada por calendários civis no mundo todo: um ano é bissexto quando é divisível por quatro, exceto que anos seculares só são bissextos quando também são divisíveis por quatrocentos. Essa regra torna legal o 29 de fevereiro em anos como 2024 e 2000, e ilegal em 2023 e 1900.
Com o status bissexto conhecido, consulte o comprimento do mês que contém a data dada: trinta e um dias para janeiro, março, maio, julho, agosto, outubro e dezembro; trinta dias para abril, junho, setembro e novembro; vinte e oito ou vinte e nove dias para fevereiro. Rejeite qualquer dia que exceda esse comprimento, por exemplo 31 de abril ou 29 de fevereiro em um ano comum.
Quando o triple é válido, a fração decorrida do mês até aquela data é definida como o dia do mês dividido pelo comprimento do mês, e o percentual decorrido é cem vezes essa fração.
O primeiro de qualquer mês mapeia portanto para um sobre o comprimento do mês, datas no meio do mês ficam perto de um meio com um pequeno deslocamento conforme o mês tenha vinte e oito, vinte e nove, trinta ou trinta e um dias, e o último dia do mês é exatamente um e cem por cento. Os dias restantes equivalem ao comprimento do mês menos o dia do mês, a fração restante é a parcela complementar do mês e o percentual restante é essa parcela complementar vezes cem.
O que você envia e o que recebe de volta
Envie um campo de string obrigatório chamado date contendo um dia de calendário ISO estrito como dois mil vinte e quatro hífen zero dois hífen um cinco. Dias que batem com o padrão mas não são datas reais de calendário —incluindo 29 de fevereiro não bissexto e valores de mês fora de um a doze— também falham com uma mensagem que nomeia o problema para que os clientes corrijam a entrada sem adivinhar.
Checagens clássicas incluem 15 de fevereiro em um ano bissexto como quinze sobre vinte e nove, 30 de abril exatamente um e cem por cento, 1 de julho como um sobre trinta e um, e 28 de fevereiro em um ano comum exatamente um. Mantenha as solicitações pequenas, fixe nos testes a fração e o percentual arredondados, e você terá números reproduzíveis de progresso do mês para cobrança, plugins LMS e workers na borda sem montar uma biblioteca de calendário própria.
Onde uma calculadora da fração do mês decorrida aparece no trabalho real
Equipes de finanças e assinaturas rateiam cobranças mensais quando um cliente começa ou cancela no meio do ciclo e precisam de uma fração confiável que combine com datas civis em vez de segundos de epoch Unix que ignoram comprimentos de mês e fevereiros bissextos. Folha e aluguel convertem uma data de corte na parcela do mês já trabalhada ou ocupada para que holerites e livros fiquem legíveis para não engenheiros.
Painéis de produto desenham barras mensais para OKRs, cotas de uso e calendários de conteúdo e devem respeitar bissextos sem fusos do host. Software que deve ficar livre de bibliotecas de fuso ainda precisa de uma fração de calendário pura para janelas de manutenção, calendários de conformidade e widgets de produtividade pessoal definidos por datas civis e não por um relógio ao vivo.
Se mais tarde você precisar só da contagem bruta de dias de um mês, do percentual de um ano civil inteiro, dos dias inteiros decorridos desde o primeiro de janeiro, dos dias inteiros decorridos dentro de um trimestre fiscal, ou do primeiro e do último dia de um mês, trate isso como intenções de busca e páginas separadas em vez de sobrecarregar esta página de fração do mês decorrida.
Casos de uso
Rateio de assinaturas e faturas
Converta qualquer data de serviço ISO na fração decorrida daquele mês de cobrança para que créditos e encargos no meio do ciclo respeitem bissextos sem fusos do host.
Cortes de folha e de aluguel
Mapeie um corte de pagamento ou de ocupação para o percentual do mês já decorrido, mais os dias restantes, em holerites e livros que não engenheiros consigam ler.
Perguntas frequentes
Como a fração decorrida de um mês é calculada?
O último dia do mês é sempre exatamente 1.0 e 100%.
Um ano bissexto muda o resultado de fevereiro?
Sim. Fevereiros bissextos têm 29 dias, então 15 de fevereiro é 15/29 em 2024 e 15/28 em 2023. 29 de fevereiro é aceito apenas em anos bissextos.
O que acontece se a data for inválida?
Forma errada, mês fora da faixa ou dias impossíveis como 2023-02-29 são rejeitados e não cobrados.
Isso é o mesmo que dias no mês ou progresso do ano?
Não. Dias no mês devolvem só o comprimento 28–31. O progresso do ano devolve o percentual do ano civil. Esta página devolve a fração e o percentual decorridos do mês que contém a data — uma intenção de busca diferente embora as três usem matemática de calendário.
Quanto custa a calculadora da fração do mês decorrida?
A ferramenta do navegador é gratuita e roda localmente.
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/fraction-of-month \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-02-15"}'const res = await fetch("https://api.kit.forhosting.com/date/fraction-of-month", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-02-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/fraction-of-month",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-02-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fraction-of-month", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-02-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-02-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fraction-of-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-15"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.fraction_of_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
A resposta também inclui os dias restantes, a fração restante, o percentual restante, um indicador bissexto, o nome em inglês month_name e uma string de fórmula curta para que barras de progresso e planilhas de rateio fiquem consistentes.
O que você envia e o que recebe de volta
Campos ausentes, valores que não sejam string e strings que não batem com o padrão de quatro-dois-dois dígitos falham com invalid_input e não são cobrados. Em caso de sucesso a resposta ecoa a string de data normalizada, os componentes numéricos de ano, mês e dia, o month_name em inglês, days_in_month de vinte e oito a trinta e um, remaining_days até o último dia daquele mês, um booleano is_leap_year, fraction como a parcela decorrida do mês no intervalo unitário, percent como essa parcela vezes cem, remaining_fraction e remaining_percent como as parcelas complementares, e uma string formula curta que documenta a regra bissexta e a definição da fração. O preço das chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde uma calculadora da fração do mês decorrida aparece no trabalho real
Como esta capacidade é um motor de parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e a validação falha não consome saldo. Combine a execução gratuita do navegador nesta página com a API paga quando precisar da mesma fração dentro de um pipeline automatizado, e mantenha o resultado matemático inalterado ao passar de uma checagem pontual para a cobrança de produção.
Casos de integração
Painéis mensais de OKR e de uso
Marque barras de metas mensais com uma fração estável e remaining_percent a partir de entradas YYYY-MM-DD estritas, com invalid_input claro em datas ruins.