禁酒期間の計算機

sobriety_date は継続した禁酒の開始日、current_date は基準日です。このエンジンは壁時計を読みません。応答は経過した年・月・日、排他的な total_days、チップやカードに刷れる短い elapsed 句を返します。禁酒開始日が基準日より後なら invalid_input で失敗し課金されません。

経過した禁酒が市民暦の年・月・日で意味すること

この計算機は両端を時刻なしのグレゴリオ日付として扱うので、開始 2020-01-15 と基準日 2026-07-25 は六年六か月十日となり、それら二つの真夜中のあいだの市民日の排他的な数え total_days が付きます。sobriety_date が current_date と一致すればエンジンは年ゼロ、月ゼロ、日ゼロ、total_days ゼロを返し、一日目の正直な排他経過です。

入力契約、未来の開始の規則、応答の形

基準日が必須なのは、このエンジンが純粋な parse だからです。壁時計を読まず、Date オブジェクトを組み立てず、時間帯を参照しないので、未来の検査はあなたが渡す日付に対してしかできません。各欄は元年から九千九百九十九年までの実在するグレゴリオ日として検証され、閏日の規則も含みます。まだ起きていない開始に対する経過禁酒は未定義で、その失敗は課金されません。例は '6 years, 6 months, 10 days' や '1 year, 0 months, 1 day' です。任意の出力キーは null にせず省略します。チップの銘が必要なら数字に独自の文を添えてください。必須の暦フィールド二つを含む JSON オブジェクトを POST してください。sobriety_date は継続した禁酒の最初の日で、四桁の年、ハイフン、二桁の月、ハイフン、二桁の日の厳密な文字列です。日誌や用紙がいつもの名前を保てるよう、別名 start_date、sober_since、date_from を受け付けます。current_date は今日、または経過を報告したい日として使う基準日です。別名 as_of、as_of_date、today、date_to は同じ解析に対応します。四月三十一日、平年の二月二十九日、13-01、空文字、文字列以外はフィールド名付きの invalid_input で失敗します。sobriety_date が current_date より後なら、開始は基準日から見て未来にあり、タスクは invalid_input で失敗します。成功時本体は正規化した sobriety_date と current_date をエコーし、市民内訳の整数 years、months、days を返し、排他的な序数差として total_days を報告し、単数複数が正しい印刷用の句 elapsed を付けます。このエンドポイントは暦の算術だけを行い、会合の台本、医学的助言、物質使用障害の診断は出しません。

禁酒の経過時間 API が役立つ場面、料金、正直な限界

current_date を利用者の現地の暦日から固定すれば、日付変更線を越える旅人でも意図した日が見えます。前払い API 呼び出しは成功 1 件あたり $0.002 の KIT 残高を使い、検証失敗は残高を消費しません。これは暦のヒューリスティックであり、診断用の医療機器ではなく、回復プログラム、臨床家、救急の代わりでもありません。リクエストは小さく保ち、返された years、months、days、total_days をテストに固定すれば、宿題チェッカー、LMS プラグイン、エッジワーカー向けに再現可能な経過禁酒が得られ、自前の暦ライブラリを立てる必要はありません。