Dias até a meta de poupança

Um depósito zero ou negativo é rejeitado com invalid_input em vez de fingir que o infinito é um plano; saldos negativos também são rejeitados. Quando a poupança atual já atinge ou supera a meta, days é zero e already_reached é true. 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 toda vez que você a chama.

O que significam os dias até a meta com depósito diário ou semanal fixo

Aplica apenas a aritmética: remaining é o máximo entre zero e goal menos current; deposits é zero quando remaining é zero, caso contrário o teto de remaining sobre deposit; days é deposits no diário ou deposits vezes sete no semanal.

Como chamar a API e o que retorna

Prefira números puros a strings formatadas como moeda; strings numéricas só são aceitas quando batem com um padrão numérico finito estrito sem cifrões nem vírgulas. Envie um corpo JSON com quatro campos obrigatórios: goal (aliases target, savings_goal, amount), a meta de poupança não negativa como número finito; current (aliases current_savings, saved, balance), o valor não negativo já poupado; deposit (aliases deposit_amount, contribution, amount_per_period), o valor fixo positivo por período; e frequency (aliases period, cadence, deposit_frequency), a string daily ou weekly, sem distinguir maiúsculas, aceitando também as formas curtas day, d, week e w. Os valores absolutos dos campos monetários devem permanecer dentro de um trilhão para que produtos intermediários continuem finitos em precisão dupla IEEE no Worker e no navegador. O valor do depósito deve ser estritamente positivo; zero, quase zero ou negativo é rejeitado com invalid_input porque um depósito não positivo nunca fecha um hiato positivo. Em sucesso, a resposta ecoa goal, current e deposit arredondados; define frequency no token normalizado daily ou weekly; remaining no valor não negativo ainda necessário; deposits_needed na contagem inteira de depósitos; days na contagem de dias de calendário; weeks e days_remainder num desdobramento conveniente do horizonte em dias; total_contributed em deposits_needed vezes deposit; already_reached num booleano; formula na string documentada; message num resumo curto em inglês; e steps num 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, depósito não positivo, frequency desconhecida, ou remaining ou deposits calculados não finitos—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 landing mira quem busca dias até uma meta de poupança com depósito fixo, uma calculadora de cofrinho, ou quantos dias com contribuições diárias ou semanais online; não é uma ferramenta de valor futuro com juros compostos, não é um planejador de meses até a meta (use uma calculadora orientada a meses para essa intenção) e não é uma tabela de amortização de empréstimo. Prefira esta capacidade quando você já conhece as cifras e só precisa da contagem linear de dias sob cadência diária ou semanal; se o plano inclui juros, aumentos ou linguagem de orçamento mensal, escolha em vez disso um modelo de crescimento ou mensal. Use a mesma unidade de moeda para goal, current e deposit—não misture dólares e centavos como se fossem a mesma escala sem converter antes. Mantenha o depósito estritamente positivo; 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 mil com current duzentos e cinquenta diários para um caminho exato de dezesseis dias; um caso semanal em que remaining não é múltiplo do depósito de modo que o teto acrescenta uma semana extra e multiplica os dias por sete; um caso em que current já iguala ou supera a meta de modo que days é zero; e um depósito deliberadamente zero para demonstrar o caminho duro 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 um depósito inválido. Checagens de ida e volta são fáceis: recalcule à mão o máximo de zero e goal menos current, divida por deposit, tome o teto, multiplique por um ou por sete conforme a frequência, e confirme que coincide com os days publicados sob o mesmo arredondamento de doze casas nos campos monetários.