Jours pour atteindre l'épargne

Un dépôt nul ou négatif est rejeté avec invalid_input au lieu de prétendre que l'infini est un plan ; les soldes négatifs sont aussi rejetés. Lorsque l'épargne actuelle atteint ou dépasse déjà l'objectif, days vaut zéro et already_reached vaut true. Le chemin est une arithmétique purement déterministe—sans réseau, sans modèle d'intérêts, sans graine aléatoire, sans dépendance à l'horloge—si bien 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.

Ce que signifient les jours jusqu'à l'objectif avec un dépôt fixe quotidien ou hebdomadaire

Il n'applique que l'arithmétique : remaining égale le maximum de zéro et goal moins current ; deposits égale zéro quand remaining est zéro, sinon le plafond de remaining sur deposit ; days égale deposits en quotidien ou deposits multiplié par sept en hebdomadaire.

Comment appeler l'API et ce qui est renvoyé

Préférez des nombres nus aux chaînes formatées en devise ; les chaînes numériques ne sont acceptées que si elles correspondent à un motif numérique fini strict sans signes dollar ni virgules. Envoyez un corps JSON avec quatre champs obligatoires : goal (alias target, savings_goal, amount), l'objectif d'épargne non négatif comme nombre fini ; current (alias current_savings, saved, balance), le montant non négatif déjà épargné ; deposit (alias deposit_amount, contribution, amount_per_period), le montant fixe positif par période ; et frequency (alias period, cadence, deposit_frequency), la chaîne daily ou weekly, insensible à la casse, les formes courtes day, d, week et w étant aussi acceptées. Les valeurs absolues des champs monétaires doivent rester dans un trillion pour que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. Le montant du dépôt doit être strictement positif ; une valeur nulle, quasi nulle ou négative est rejetée avec invalid_input car un dépôt non positif ne comble jamais un écart positif. En cas de succès, la réponse renvoie goal, current et deposit arrondis ; fixe frequency au jeton normalisé daily ou weekly ; remaining au montant non négatif encore nécessaire ; deposits_needed au nombre entier de dépôts ; days au nombre de jours calendaires ; weeks et days_remainder à une décomposition pratique de l'horizon en jours ; total_contributed à deposits_needed multiplié par deposit ; 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, goal ou current négatif, dépôt non positif, frequency inconnue, ou remaining ou deposits calculés non finis—renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait $0.002 par requête réussie avec unité item.

Conseils pratiques, limites et recherches associées

Cette page vise les personnes qui cherchent des jours pour atteindre un objectif d'épargne avec un dépôt fixe, un calculateur de tirelire, ou combien de jours avec des versements quotidiens ou hebdomadaires en ligne ; ce n'est pas un outil de valeur future à intérêts composés, pas un planificateur de mois jusqu'à l'objectif (utilisez un calculateur orienté mois pour cette intention) et pas un tableau d'amortissement de prêt. Préférez cette capacité lorsque vous connaissez déjà les montants et n'avez besoin que du décompte linéaire de jours sous cadence quotidienne ou hebdomadaire ; si votre plan inclut intérêts, hausses ou langage de budget mensuel, choisissez plutôt un modèle de croissance ou mensuel. Utilisez la même unité monétaire pour goal, current et deposit—ne mélangez pas dollars et cents comme s'ils avaient la même échelle sans convertir d'abord. Gardez le dépôt strictement positif ; les expériences gratuites dans le navigateur qui envoient zéro toucheront correctement invalid_input et ne seront pas facturées sur l'API. Pour enseigner ou tester, couplez des exemples : objectif mille avec current deux cents et cinquante par jour pour un chemin exact de seize jours ; un cas hebdomadaire où remaining n'est pas un multiple du dépôt de sorte que le plafond ajoute une semaine et multiplie les jours par sept ; un cas où current égale ou dépasse déjà l'objectif de sorte que days vaut zéro ; et un dépôt volontairement nul pour démontrer le chemin dur invalid_input. Les tâches en échec 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 un mauvais dépôt. Les contrôles aller-retour sont simples : recalculez à la main le maximum de zéro et goal moins current, divisez par deposit, prenez le plafond, multipliez par un ou par sept selon la fréquence, et confirmez l'égalité avec les days publiés sous le même arrondi à douze décimales sur les champs monétaires.