Calculadora de tiempo a meta de ahorro

Un aporte mensual cero se rechaza con invalid_input en lugar de pretender que el infinito es un plan; también se rechazan depósitos negativos y saldos negativos. Cuando el ahorro actual ya alcanza o supera la meta, months es cero y already_reached es verdadero. El camino es aritmética determinista pura —sin red, sin modelo de interés, sin semilla aleatoria, sin dependencia del reloj— de modo que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON tras el redondeo decimal fijo cada vez que la invoca.

Cómo llamar a la API y qué devuelve

Prefiera números desnudos frente a cadenas con formato de moneda; los números en cadena solo se aceptan cuando coinciden con un patrón numérico finito estricto sin signos de dólar ni comas. Envíe un cuerpo JSON con tres números finitos obligatorios: goal (alias target, savings_goal, amount), el objetivo de ahorro no negativo; current (alias current_savings, saved, balance), el monto no negativo ya ahorrado; y monthly (alias contribution, monthly_contribution, deposit), el aporte mensual fijo positivo. Los valores absolutos deben permanecer dentro de un billón para que los productos intermedios sigan siendo finitos en precisión doble IEEE en el Worker y en el navegador. El aporte mensual debe ser estrictamente positivo; un valor de cero o casi cero se rechaza con invalid_input porque un depósito cero nunca cierra la brecha, y un depósito negativo también se rechaza. En caso de éxito la respuesta repite goal, current y monthly redondeados; fija remaining al monto no negativo aún necesario; months al recuento de meses enteros; years y months_remainder a la división entera de months en bloques de doce meses; total_contributed a months por monthly; already_reached a un booleano; formula a la cadena documentada; message a un resumen breve en inglés; y steps a un array ordenado de líneas de sustitución. La validación fallida —campos ausentes, números no finitos, valores fuera de límites absolutos, un goal o current negativo, un aporte monthly cero o negativo, o un remaining o months calculado no finito— devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición exitosa con unidad item y precio unitario marginal cero.

Consejos prácticos, límites y búsquedas relacionadas

Esta página apunta a quienes buscan una calculadora de tiempo a meta de ahorro, meses para ahorrar un objetivo, o cuánto tarda con un aporte mensual fijo en línea; no es una herramienta de valor futuro con interés compuesto, ni un calendario de amortización de préstamo, ni un Monte Carlo de jubilación. Prefiera esta capacidad cuando ya conozca las tres cifras de dinero y solo necesite el recuento lineal de meses; si su plan incluye interés o aumentos, use en su lugar un modelo de crecimiento dedicado. Las comprobaciones de ida y vuelta son fáciles: recalcule a mano el máximo de cero y meta menos actual, divida por monthly, tome el techo y confirme que iguala el months publicado con el mismo redondeo a doce decimales en los campos de dinero. Use la misma unidad de moneda para goal, current y monthly —no mezcle dólares y centavos como si fueran la misma escala sin convertir primero. Mantenga el aporte mensual estrictamente positivo; los experimentos gratuitos del navegador que envían cero acertarán invalid_input y no se cobrarán en la API. Al enseñar o probar, combine ejemplos: meta de diez mil con actual de dos mil quinientos y monthly de quinientos para un camino exacto de quince meses; un caso donde remaining no es múltiplo del depósito de modo que el techo añade un mes extra; un caso donde current ya iguala o supera la meta de modo que months es cero; y un aporte monthly deliberadamente cero para demostrar la ruta dura de invalid_input. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando los desarrolladores envían a propósito un aporte cero.