Calculateur délai d'objectif d'épargne

Une contribution mensuelle nulle est rejetée avec invalid_input au lieu de prétendre que l'infini est un plan ; les dépôts négatifs et les soldes négatifs sont aussi rejetés. Lorsque l'épargne actuelle atteint ou dépasse déjà l'objectif, months vaut zéro et already_reached est vrai. Le chemin est de l'arithmétique déterministe pure —sans réseau, sans modèle d'intérêt, sans graine aléatoire, sans dépendance à l'horloge— de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après l'arrondi décimal fixe à chaque appel.

Comment appeler l'API et ce qui revient

Préférez les nombres bruts aux chaînes formatées en devise ; les nombres en chaîne ne sont acceptés que s'ils correspondent à un motif numérique fini strict sans signes dollar ni virgules de milliers. Envoyez un corps JSON avec trois nombres finis obligatoires : goal (alias target, savings_goal, amount), la cible d'épargne non négative ; current (alias current_savings, saved, balance), le montant non négatif déjà épargné ; et monthly (alias contribution, monthly_contribution, deposit), la contribution mensuelle fixe positive. Les valeurs absolues doivent rester dans un billion afin que les produits intermédiaires restent finis en précision double IEEE sur le Worker et dans le navigateur. La contribution mensuelle doit être strictement positive ; une valeur nulle ou quasi nulle est rejetée avec invalid_input car un dépôt nul ne ferme jamais l'écart, et un dépôt négatif est aussi rejeté. En cas de succès la réponse renvoie goal, current et monthly arrondis ; fixe remaining au montant non négatif encore nécessaire ; months au décompte de mois entiers ; years et months_remainder à la division entière de months en blocs de douze mois ; total_contributed à months multiplié par monthly ; already_reached à un booléen ; formula à la chaîne documentée ; message à un court résumé en anglais ; et steps à un tableau ordonné de lignes de substitution. Une validation échouée —champs manquants, nombres non finis, valeurs hors limites absolues, un goal ou current négatif, une contribution monthly nulle ou négative, ou un remaining ou months calculé non fini— renvoie invalid_input et n'est jamais facturée. Le tarif est un $0.002 fixe par requête réussie avec unité item et prix unitaire marginal zéro.

Conseils pratiques, limites et recherches associées

Cette page vise les personnes qui cherchent un calculateur de délai d'objectif d'épargne, des mois pour épargner une cible, ou combien de temps avec une contribution mensuelle fixe en ligne ; ce n'est pas un outil de valeur future à intérêts composés, ni un échéancier d'amortissement de prêt, ni un Monte Carlo de retraite. Préférez cette capacité lorsque vous connaissez déjà les trois chiffres monétaires et n'avez besoin que du décompte linéaire de mois ; si votre plan inclut des intérêts ou des augmentations, utilisez plutôt un modèle de croissance dédié. Les contrôles aller-retour sont simples : recalculez à la main le maximum de zéro et objectif moins actuel, divisez par monthly, prenez le plafond et confirmez qu'il égale le months publié avec le même arrondi à douze décimales sur les champs monétaires. Utilisez la même unité monétaire pour goal, current et monthly —ne mélangez pas dollars et cents comme s'ils étaient à la même échelle sans convertir d'abord. Gardez la contribution mensuelle strictement positive ; les expériences gratuites du navigateur qui envoient zéro toucheront correctement invalid_input et ne seront pas facturées sur l'API. Pour enseigner ou tester, combinez des exemples : objectif de dix mille avec current de deux mille cinq cents et monthly de cinq cents pour un chemin exact de quinze mois ; un cas où remaining n'est pas un multiple du dépôt de sorte que le plafond ajoute un mois extra ; un cas où current égale ou dépasse déjà l'objectif de sorte que months vaut zéro ; et une contribution monthly délibérément nulle pour démontrer le chemin dur d'invalid_input. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires bon marché lorsque les développeurs envoient volontairement une contribution nulle.