حاسبة الصحو

أرسلوا تاريخين من التقويم الغريغوري بصيغة YYYY-MM-DD. sobriety_date هو بدء الصحو المتصل، و current_date هو يوم المرجع لأن هذا المحرك لا يقرأ ساعة جدارية أبدًا. تبلّغ الاستجابة عن السنوات والأشهر والأيام المنقضية، والعدّ الحصري total_days، وعبارة قصيرة elapsed يمكن طبعها على شريحة أو بطاقة. إذا وقع تاريخ الصحو بعد التاريخ الحالي تفشل المهمة بـ invalid_input ولا تُحسب. الدالة الخالصة نفسها تشغّل أداة المتصفح المجانية وAPI المدفوعة مسبقًا، فلا تختلف شريحة مطبوعة عن مهمة أتمتة في ذكرى البدء.

ماذا يعني الصحو المنقضي بسنوات وأشهر وأيام مدنية

تعامل هذه الحاسبة الطرفين كتاريخين غريغوريين بلا وقت في اليوم، فبداية 2020-01-15 ويوم مرجع 2026-07-25 تعني ست سنوات وستة أشهر وعشرة أيام، مع عدّ حصري total_days للأيام المدنية الكاملة بين ذينك منتصفي الليل. التاريخ نفسه في الحقلين مدى صفر صالح: إذا طابق sobriety_date قيمة current_date يعيد المحرك صفر سنوات وصفر أشهر وصفر أيام و total_days صفرًا، وهو الزمن الحصري الصادق في اليوم الأول. لا تقرأ الأداة ساعة المضيف ولا تبني إزاحة منطقة زمنية ولا تخمّن إن كنتم تقصدون منتصف الليل المحلي أو UTC، لأن تلك الاختيارات تجعل الأداة المجانية وAPI تختلفان على جانبي خط تغيير التاريخ.

عقد الإدخال وقاعدة البدء المستقبلي وشكل الاستجابة

يوم المرجع إلزامي لأن هذا المحرك parse خالص: لا يقرأ ساعة جدارية ولا يبني كائن Date ولا يستشير منطقة زمنية، لذا لا يمكن فحص المستقبل إلا مقابل تاريخ تقدّمونه. تُحذف مفاتيح الخروج الاختيارية بدل ضبطها على null. اقرنوا الأرقام بنصكم إن أردتم نقشًا على الشريحة؛ فهذه النقطة الطرفية تجري حساب التقويم فقط ولا تُصدر نصوص اجتماع ولا مشورة طبية ولا تشخيص اضطراب استعمال مواد. أرسلوا POST لجسم JSON بحقلين تقويميين إلزاميين. sobriety_date هو أول يوم للصحو المتصل كسلسلة صارمة من سنة بأربعة أرقام ثم شرطة ثم شهر برقمين ثم شرطة ثم يوم برقمين؛ وتُقبل الأسماء البديلة start_date و sober_since و date_from حتى تحتفظ اليوميات والنماذج بأسمائها المعتادة. current_date هو يوم المرجع المستخدم كاليوم أو كاليوم الذي تريدون إبلاغ الزمن المنقضي عنده؛ والأسماء as_of و as_of_date و today و date_to تقابل التحليل نفسه. يُتحقق من كل حقل كيوم غريغوري حقيقي في السنوات من واحد إلى تسعة آلاف وتسعمئة وتسعة وتسعين، بما في ذلك قواعد اليوم الكبيس، فقيم مثل 31 أبريل و29 فبراير في سنة مشتركة و13-01 والسلاسل الفارغة وغير السلاسل تفشل بـ invalid_input مع تسمية الحقل. إذا وقع sobriety_date بعد current_date فالبدء في المستقبل نسبة إلى يوم المرجع وتفشل المهمة بـ invalid_input؛ والصحو المنقضي غير معرّف لبدء لم يحدث بعد، وذلك الإخفاق لا يُحسب. عند النجاح يعيد الجسم سلسلتي sobriety_date و current_date بعد التطبيع، ويعيد أعدادًا صحيحة years و months و days من التفصيل المدني، ويبلّغ total_days كالفرق الرتبي الحصري، ويرفق elapsed عبارة قابلة للطباعة بوحدات مفرد وجمع صحيحة مثل '6 years, 6 months, 10 days' أو '1 year, 0 months, 1 day'.

أين تنفع واجهة زمن الصحو المنقضي والتسعير والحدود الصادقة

يمكن لتطبيقات العافية ويوميات التعافي وروبوتات المرافقة استدعاء العقد نفسه بدل إعادة ترميز جداول السنوات الكبيسة في كل عميل، مع تثبيت current_date من يوم التقويم المحلي للشخص حتى يرى من يعبر خط تغيير التاريخ اليوم الذي قصده. تستعمل طلبات API المدفوعة مسبقًا رصيد KIT بسعر $0.002 لكل عنصر ناجح؛ وإخفاقات التحقق لا تستهلك الرصيد أبدًا. هذه إرشادية تقويم لا جهاز طبي تشخيصي ولا بديلًا عن برنامج تعاف أو سريري أو رعاية طارئة. أبقوا الطلبات صغيرة وثبّتوا في الاختبارات years و months و days و total_days المعادة لتحصلوا على صحو منقضٍ قابل للتكرار لمصححي الواجبات وإضافات LMS وعاملات الحافة دون إقامة مكتبة تقويم خاصة بكم.