Calculateur de sobriété

Envoyez deux dates du calendrier grégorien au format YYYY-MM-DD. sobriety_date est le début de la sobriété continue, et current_date est le jour de référence car ce moteur ne lit jamais une horloge murale. La réponse indique les années, mois et jours écoulés, le décompte exclusif total_days et une courte phrase elapsed que vous pouvez imprimer sur un jeton ou une carte. Si la date de sobriété tombe après la date actuelle, la tâche échoue avec invalid_input et n'est pas facturée.

Ce que le temps de sobriété écoulé signifie en années, mois et jours civils

Ce calculateur traite les deux extrémités comme des dates grégoriennes sans heure du jour, de sorte qu'un début 2020-01-15 et un jour de référence 2026-07-25 valent six ans, six mois et dix jours, avec un décompte exclusif total_days des jours civils entiers entre ces deux minuits. La même date aux deux champs est un intervalle zéro valable : si sobriety_date coïncide avec current_date le moteur renvoie zéro année, zéro mois, zéro jour et total_days de zéro, le temps exclusif honnête au jour un.

Contrat d'entrée, règle du début futur et forme de la réponse

Le jour de référence est obligatoire car ce moteur est parse pur : il ne lit jamais une horloge murale, ne construit jamais un objet Date et ne consulte jamais un fuseau horaire, donc une vérification de futur n'est possible que contre une date que vous fournissez. Les clés de sortie facultatives sont omises plutôt que fixées à null. Associez les chiffres à votre propre texte si vous voulez une inscription sur le jeton ; ce point d'accès ne fait que l'arithmétique de calendrier et n'émet ni scripts de réunion, ni conseil médical, ni diagnostic de trouble lié à l'usage de substances. Envoyez par POST un objet JSON avec deux champs de calendrier obligatoires. sobriety_date est le premier jour de sobriété continue sous forme de chaîne stricte année à quatre chiffres, trait d'union, mois à deux chiffres, trait d'union et jour à deux chiffres ; les alias start_date, sober_since et date_from sont acceptés afin que journaux et formulaires gardent leurs noms habituels. current_date est le jour de référence utilisé comme aujourd'hui ou comme le jour dont vous voulez le temps écoulé ; les alias as_of, as_of_date, today et date_to correspondent à la même analyse. Chaque champ est validé comme jour grégorien réel des années un à neuf mille neuf cent quatre-vingt-dix-neuf, y compris les règles du jour bissextile, de sorte que des valeurs comme le 31 avril, le 29 février une année commune, 13-01, les chaînes vides et les non-chaînes échouent avec invalid_input en nommant le champ. Si sobriety_date tombe après current_date le début est dans le futur par rapport au jour de référence et la tâche échoue avec invalid_input ; le temps de sobriété écoulé n'est pas défini pour un début qui n'a pas encore eu lieu, et cet échec n'est pas facturé. En cas de succès le corps renvoie les chaînes normalisées sobriety_date et current_date, des entiers years, months et days issus du détail civil, total_days comme différence ordinale exclusive, et elapsed, une phrase imprimable avec les unités au singulier et au pluriel correctes, par exemple '6 years, 6 months, 10 days' ou '1 year, 0 months, 1 day'.

Où une API de temps de sobriété écoulé trouve sa place, tarifs et limites honnêtes

Les applications de bien-être, les journaux de rétablissement et les robots d'accompagnement peuvent appeler le même contrat au lieu de recoder des tables d'années bissextiles dans chaque client, en figeant current_date depuis le jour de calendrier local de la personne afin qu'un voyageur qui traverse une ligne de date voie encore le jour visé. Les appels API prépayés utilisent le solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde. Gardez les requêtes petites, figez dans les tests les years, months, days et total_days renvoyés, et vous obtenez une sobriété écoulée reproductible pour les correcteurs de devoirs, les greffons LMS et les workers de bord sans dresser une bibliothèque de calendrier à vous.