Días hasta la meta de ahorro

Un depósito cero o negativo se rechaza con invalid_input en lugar de fingir que el infinito es un plan; los saldos negativos también se rechazan. Cuando el ahorro actual ya alcanza o supera la meta, days es cero y already_reached es true. El camino es aritmética determinista pura—sin red, sin modelo de intereses, 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 se invoca.

Qué significan los días hasta la meta con un depósito diario o semanal fijo

Solo aplica la aritmética: remaining es el máximo entre cero y goal menos current; deposits es cero cuando remaining es cero, en caso contrario el techo de remaining sobre deposit; days es deposits en diario o deposits por siete en semanal.

Cómo llamar a la API y qué se devuelve

Prefiera números desnudos frente a cadenas con formato de moneda; las cadenas numéricas solo se aceptan si coinciden con un patrón numérico finito estricto sin signos de dólar ni comas. Envíe un cuerpo JSON con cuatro campos obligatorios: goal (alias target, savings_goal, amount), la meta de ahorro no negativa como número finito; current (alias current_savings, saved, balance), el importe no negativo ya ahorrado; deposit (alias deposit_amount, contribution, amount_per_period), el importe fijo positivo por periodo; y frequency (alias period, cadence, deposit_frequency), la cadena daily o weekly, sin distinguir mayúsculas, aceptando también las formas cortas day, d, week y w. Los valores absolutos de los campos monetarios deben permanecer dentro de un billón (inglés: trillion) para que los productos intermedios sigan siendo finitos en doble precisión IEEE en el Worker y en el navegador. El importe del depósito debe ser estrictamente positivo; un valor cero, casi cero o negativo se rechaza con invalid_input porque un depósito no positivo nunca cierra un hueco positivo. En caso de éxito, la respuesta repite goal, current y deposit redondeados; fija frequency al token normalizado daily o weekly; remaining al importe no negativo aún necesario; deposits_needed al recuento entero de depósitos; days al recuento de días de calendario; weeks y days_remainder a un desglose cómodo del horizonte en días; total_contributed a deposits_needed por deposit; 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, goal o current negativos, depósito no positivo, frequency desconocida, o remaining o deposits calculados no finitos—devuelve invalid_input y nunca se cobra. El precio es un fijo $0.002 por petición exitosa con unidad item.

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

Esta página apunta a quienes buscan días hasta una meta de ahorro con depósito fijo, una calculadora de hucha, o cuántos días con aportaciones diarias o semanales en línea; no es una herramienta de valor futuro con interés compuesto, no es un planificador de meses hasta la meta (use una calculadora orientada a meses para esa intención) y no es un cuadro de amortización de préstamo. Prefiera esta capacidad cuando ya conoce las cifras y solo necesita el recuento lineal de días bajo cadencia diaria o semanal; si su plan incluye intereses, subidas o lenguaje de presupuesto mensual, elija en su lugar un modelo de crecimiento o mensual. Use la misma unidad de moneda para goal, current y deposit—no mezcle dólares y céntimos como si fueran la misma escala sin convertir antes. Mantenga el depósito estrictamente positivo; los experimentos gratuitos en el navegador que envían cero acertarán invalid_input y no se cobrarán en la API. Al enseñar o probar, empareje ejemplos: meta mil con current doscientos y cincuenta diarios para un camino exacto de dieciséis días; un caso semanal donde remaining no es múltiplo del depósito de modo que el techo añade una semana extra y multiplica los días por siete; un caso en que current ya iguala o supera la meta de modo que days es cero; y un depósito deliberadamente cero para demostrar la vía dura 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 depósito incorrecto. Las comprobaciones de ida y vuelta son fáciles: recalcule a mano el máximo de cero y goal menos current, divida por deposit, tome el techo, multiplique por uno o por siete según la frecuencia, y confirme que coincide con los days publicados bajo el mismo redondeo a doce decimales en los campos monetarios.