Calculadora de tempo até meta de poupança

Uma contribuição mensal zero é rejeitada com invalid_input em vez de fingir que o infinito é um plano; depósitos negativos e saldos negativos também são rejeitados. Quando a poupança atual já atinge ou supera a meta, months é zero e already_reached é verdadeiro. O caminho é aritmética determinística pura —sem rede, sem modelo de juros, sem semente aleatória, sem dependência de relógio— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo sempre que você a chama.

Como chamar a API e o que volta

Prefira números puros a strings formatadas como moeda; números em string só são aceitos quando batem com um padrão numérico finito estrito sem cifrões ou vírgulas. Envie um corpo JSON com três números finitos obrigatórios: goal (aliases target, savings_goal, amount), o alvo de poupança não negativo; current (aliases current_savings, saved, balance), o valor não negativo já poupado; e monthly (aliases contribution, monthly_contribution, deposit), a contribuição mensal fixa positiva. Os valores absolutos devem permanecer dentro de um trilhão para que produtos intermediários permaneçam finitos em precisão dupla IEEE no Worker e no navegador. A contribuição mensal deve ser estritamente positiva; um valor de zero ou quase zero é rejeitado com invalid_input porque um depósito zero nunca fecha a lacuna, e um depósito negativo também é rejeitado. Em caso de sucesso a resposta ecoa goal, current e monthly arredondados; define remaining com o valor não negativo ainda necessário; months com a contagem de meses inteiros; years e months_remainder com a divisão inteira de months em blocos de doze meses; total_contributed com months vezes monthly; already_reached com um booleano; formula com a string documentada; message com um resumo curto em inglês; e steps com um array ordenado de linhas de substituição. Validação falha —campos ausentes, números não finitos, valores fora dos limites absolutos, um goal ou current negativo, uma contribuição monthly zero ou negativa, ou remaining ou months calculado não finito— retorna invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item e preço unitário marginal zero.

Dicas práticas, limites e buscas relacionadas

Esta página atende quem busca calculadora de tempo até meta de poupança, meses para economizar um alvo, ou quanto tempo com contribuição mensal fixa online; não é uma ferramenta de valor futuro com juros compostos, nem um cronograma de amortização de empréstimo, nem um Monte Carlo de aposentadoria. Prefira esta capacidade quando você já conhece as três cifras de dinheiro e só precisa da contagem linear de meses; se o plano inclui juros ou aumentos, use em vez disso um modelo de crescimento dedicado. Checagens de ida e volta são fáceis: recalcule à mão o máximo de zero e meta menos atual, divida por monthly, pegue o teto e confirme que iguala o months publicado com o mesmo arredondamento a doze casas nos campos de dinheiro. Use a mesma unidade de moeda para goal, current e monthly —não misture dólares e centavos como se fossem a mesma escala sem converter primeiro. Mantenha a contribuição mensal estritamente positiva; experimentos gratuitos no navegador que enviam zero acertam invalid_input e não serão cobrados na API. Ao ensinar ou testar, combine exemplos: meta de dez mil com current de dois mil e quinhentos e monthly de quinhentos para um caminho exato de quinze meses; um caso em que remaining não é múltiplo do depósito de modo que o teto adiciona um mês extra; um caso em que current já iguala ou supera a meta de modo que months é zero; e uma contribuição monthly deliberadamente zero para demonstrar o caminho duro 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 uma contribuição zero.