Date d'achèvement d'objectif

Un rythme quotidien nul est rejeté avec invalid_input au lieu de prétendre que l'infini est un plan ; les rythmes négatifs et les soldes négatifs sont aussi rejetés. Le chemin est une arithmétique déterministe pure et un calendrier grégorien—sans réseau, sans Date d'horloge, sans graine aléatoire—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.

Ce que signifie la date d'achèvement avec un rythme quotidien fixe

Il n'applique que l'arithmétique : remaining égale le maximum de zéro et goal moins current, days égale zéro lorsque remaining est zéro, sinon days égale le plafond de remaining sur daily_rate, et completion_date égale start_date plus autant de jours du calendrier grégorien sans utiliser l'horloge de l'hôte.

Comment appeler l'API et ce qui est renvoyé

Les jours de calendrier impossibles comme le vingt-neuf février en année non bissextile échouent à la validation avec un message de champ clair. Envoyez un corps JSON avec quatre champs obligatoires : goal (alias target, target_amount, amount), la cible numérique non négative ; current (alias current_amount, progress, completed), la quantité non négative déjà faite ; daily_rate (alias rate, daily_progress, progress_rate), la progression quotidienne fixe positive ; et start_date (alias date, as_of, current_date), une chaîne de calendrier ISO stricte YYYY-MM-DD qui est une date grégorienne réelle. Les valeurs absolues d'argent ou de comptage doivent rester dans un billion afin que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. Le rythme quotidien doit être strictement positif ; une valeur nulle ou quasi nulle est rejetée avec invalid_input car un rythme zéro ne comble jamais un écart positif, et un rythme négatif est aussi rejeté. En cas de succès la réponse renvoie goal, current et daily_rate arrondis plus le start_date normalisé ; fixe remaining à la quantité non négative encore nécessaire ; days_needed au décompte de jours entiers ; weeks et days_remainder à la division entière des jours en blocs de sept ; amount_at_rate à jours fois rythme quotidien ; completion_date à la date ISO projetée ; 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égatifs, daily_rate nul ou négatif, date invalide ou projection hors de la plage d'années 0001–9999—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 cible ceux qui cherchent un calculateur de date d'achèvement d'objectif, une date de fin selon le rythme quotidien, ou le reste divisé par le rythme en ligne ; ce n'est pas un outil de mois d'épargne avec dépôts mensuels, ni un planificateur de jours ouvrés qui saute les week-ends, ni une prévision Monte Carlo de vélocité. Préférez cette capacité lorsque vous connaissez déjà les trois chiffres de progression et une date de référence et n'avez besoin que du jour civil linéaire d'achèvement ; si votre plan inclut intérêts, composition ou calendriers ouvrés, utilisez un modèle dédié. Utilisez la même unité pour goal, current et daily_rate—ne mélangez pas pages et mots, ni dollars et cents, sans convertir d'abord. Gardez le rythme quotidien strictement positif ; les expériences gratuites dans le navigateur qui envoient zéro frapperont correctement invalid_input et ne seront pas facturées sur l'API. Pour enseigner ou tester, associez des exemples : mille d'objectif avec deux cent cinquante actuels et vingt-cinq par jour à partir du premier janvier pour un chemin exact de trente jours jusqu'au trente et un ; un cas où le reste n'est pas multiple du rythme et le plafond ajoute un jour de plus ; un cas où current égale ou dépasse déjà l'objectif donc days est zéro et l'achèvement égale le départ ; et un rythme quotidien volontairement nul pour démontrer le chemin strict 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 délibérément un rythme nul. Les contrôles aller-retour sont simples : recalculez à la main le maximum de zéro et goal moins current, divisez par daily_rate, prenez le plafond, ajoutez ces jours civils à la date de départ avec une bibliothèque grégorienne connue ou un calendrier papier, et confirmez l'égalité avec le completion_date publié dans le même arrondi à douze décimales sur les champs de montant.