Data de conclusão da meta

Uma taxa diária zero é rejeitada com invalid_input em vez de fingir que o infinito é um plano; taxas negativas e saldos negativos também são rejeitados. O caminho é aritmética determinística pura e calendário gregoriano—sem rede, sem Date do relógio, sem semente aleatória—de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo cada vez que você a chama.

O que significa a data de conclusão da meta com taxa diária fixa

Aplica apenas a aritmética: remaining é o máximo de zero e goal menos current, days é zero quando remaining é zero, caso contrário days é o teto de remaining sobre daily_rate, e completion_date é start_date mais esses dias do calendário gregoriano sem usar o relógio do host.

Como chamar a API e o que volta

Dias de calendário impossíveis como vinte e nove de fevereiro em ano não bissexto falham na validação com mensagem clara do campo. Envie um corpo JSON com quatro campos obrigatórios: goal (aliases target, target_amount, amount), o alvo numérico não negativo; current (aliases current_amount, progress, completed), a quantidade não negativa já feita; daily_rate (aliases rate, daily_progress, progress_rate), o progresso diário fixo positivo; e start_date (aliases date, as_of, current_date), uma string de calendário ISO estrita YYYY-MM-DD que seja uma data gregoriana real. Os valores absolutos de dinheiro ou contagem devem permanecer dentro de um trilhão para que produtos intermediários fiquem finitos em precisão dupla IEEE no Worker e no navegador. A taxa diária deve ser estritamente positiva; um valor zero ou quase zero é rejeitado com invalid_input porque taxa nula nunca fecha um gap positivo, e taxa negativa também é rejeitada. Em sucesso a resposta ecoa goal, current e daily_rate arredondados mais o start_date normalizado; define remaining como a quantidade não negativa ainda necessária; days_needed como a contagem de dias inteiros; weeks e days_remainder como a divisão inteira dos dias em blocos de sete; amount_at_rate como dias vezes taxa diária; completion_date como a data ISO projetada; already_reached como booleano; formula como a string documentada; message como um resumo curto em inglês; e steps como um array ordenado de linhas de substituição. Validação falha—campos ausentes, números não finitos, valores fora dos limites absolutos, goal ou current negativos, daily_rate zero ou negativo, data inválida ou projeção que saia do intervalo de anos 0001–9999—retorna invalid_input e nunca é cobrada. O preço é um valor fixo US$ 0,002 por requisição bem-sucedida com unidade item.

Dicas práticas, limites e buscas relacionadas

Esta página atende quem busca calculadora de data de conclusão de meta, data final a partir da taxa diária de progresso ou restante dividido pela taxa online; não é ferramenta de meses de poupança com depósitos mensais, nem agendador de dias úteis que pula fins de semana, nem previsão Monte Carlo de velocidade. Prefira esta capacidade quando você já conhece as três cifras de progresso e uma data de referência e só precisa do dia de calendário linear de conclusão; se o plano inclui juros, capitalização ou calendários de dias úteis, use um modelo dedicado. Use a mesma unidade para goal, current e daily_rate—não misture páginas e palavras, nem dólares e centavos, sem converter primeiro. Mantenha a taxa diária estritamente positiva; experimentos gratuitos no navegador que enviem zero acertarão invalid_input e não serão cobrados na API. Ao ensinar ou testar, combine exemplos: mil de meta com duzentas e cinquenta atuais e vinte e cinco por dia a partir de primeiro de janeiro para um caminho exato de trinta dias até o dia trinta e um; um caso em que o restante não é múltiplo da taxa e o teto acrescenta um dia extra; um caso em que current já iguala ou supera a meta e days é zero e a conclusão coincide com o início; e uma taxa diária deliberadamente zero para demonstrar o caminho rígido de invalid_input. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando desenvolvedores enviam de propósito taxa nula. Checagens de ida e volta são simples: recalcule à mão o máximo de zero e goal menos current, divida por daily_rate, tome o teto, some esses dias de calendário à data de início com uma biblioteca gregoriana conhecida ou um calendário em papel, e confirme que coincide com o completion_date publicado no mesmo arredondamento de doze casas nos campos de quantidade.