ForHosting KIT · أدوات المطورين

الفرق بين تاريخين وحاسبة العمر

يبحث كثيرون عن عدد الأيام بين تاريخين وعن عمر موثوق بالسنوات والأشهر والأيام. تجيب هذه الأداة عن السؤالين بقواعد التقويم المدني فقط: بلا مناطق زمنية ولا أيام عمل ولا تقريب خفي. تحصل على إجمالي الأيام وتفصيلاً موقّعاً بالسنوات والأشهر والأيام وعلى الزوج المرتّب المستخدم في الحساب.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تواريخ مدنية فقط — بلا ساعة ولا منطقة زمنية

كل إدخال هو يوم تقويمي بصيغة YYYY-MM-DD. لا يستشير الحساب الساعات ولا التوقيت الصيفي ولا ساعة الخادم من أجل الفرق نفسه. بذلك يبقى الزوج نفسه من التواريخ مستقراً في الأداة المجانية بالمتصفح وفي واجهة البرمجة. تُرفض الأيام غير الصالحة مثل 2023-02-29 أو 2024-04-31 بدلاً من تعديلها بصمت، حتى لا يتحول خطأ كتابي إلى ذكرى سنوية خاطئة.

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

يستخدم التفصيل أشهر التقويم مع تثبيت على آخر يوم صالح: إضافة شهر إلى 2024-01-31 تعطي 2024-02-29 لا يوماً مختلقاً في مارس. إذا تجاوز شهر مؤقت تاريخ النهاية يتراجع الخوارزم شهراً واحداً ويحسب الأيام الكاملة المتبقية. لذلك من 2024-01-31 إلى 2024-02-29 شهر واحد وصفر أيام، ومن 2024-01-31 إلى 2024-02-28 صفر أشهر وثمانية وعشرون يوماً. إجمالي الأيام يستثني يوم البداية: التاريخ نفسه يعطي صفراً.

وضع الفرق ووضع العمر يشتركان في نفس المرجع الحسابي

يقارن وضع الفرق date_from مع date_to ويعيد total_days وyears وmonths وdays وsign والزوج المرتّب. يستخدم وضع العمر birthdate وreference_date صريحاً لنتائج حتمية؛ وإذا حذفت المرجع في الأداة المجانية تُستخدم التاريخ المدني المحلي للجهاز. عددياً العمر هو نفس دالة الفرق بأسماء حقول مختلفة، فلا يمكن لعمر بمرجع ثابت أن يختلف عن فرق ذلك الزوج نفسه.

نتائج بإشارة عندما ينعكس الترتيب

إذا سبق تاريخ النهاية تاريخ البداية لا تبدّل الأداة المدخلات بصمت. تحافظ على الترتيب المُرسل في حقول الصدى وتضع إشارة سالبة على إجمالي الأيام وعلى التفصيل. تغطي هذه التماثل أعياد الميلاد المستقبلية والفترات المعكوسة والفحوصات الآلية التي يجب أن تكتشف فترة مقلوبة دون مسار رمز ثانٍ.

حالات الاستخدام

أيام بين مرحلتين في مشروع

قِس أيام التقويم الحصرية بين البداية والموعد دون خلط عطل نهاية الأسبوع أو الأعياد أو المناطق الزمنية.

عمر مدني للنماذج والأهلية

احسب السنوات والأشهر والأيام مقابل تاريخ مرجعي ثابت لتبقى المراجعات والتصديرات قابلة للتكرار.

الذكرى السنوية وحدود 29 فبراير

عالِج أعياد الميلاد في 29 فبراير وأزواج نهاية الشهر بنفس قاعدة التثبيت المستخدمة في الأشهر العادية.

فحوصات آلية للفترات

استدعِ واجهة البرمجة من مسار عمل واحفظ total_days مع التفصيل الموقّع في سجلات التدقيق.

الأسئلة الشائعة

هل عدّ الأيام شامل أم غير شامل؟

غير شامل ليوم البداية. التاريخ نفسه يعطي صفراً من إجمالي الأيام؛ اليوم المدني التالي يعطي واحداً.

كيف تُعالَج نهاية الشهر؟

تُضاف الأشهر مع تثبيت على آخر يوم صالح من شهر الوجهة، ثم تُصحَّح إذا تجاوز التاريخ الوسيط تاريخ النهاية. تكمل الأيام الكاملة المتبقية التفصيل.

ماذا عن 29 فبراير في سنة غير كبيسة؟

الذكرى من 2024-02-29 إلى 2025-02-28 سنة واحدة وصفر أشهر وصفر أيام وفق قاعدة التثبيت. تُرفض المدخلات غير الصالحة مثل 2023-02-29.

بماذا يختلف هذا عن أيام العمل؟

تحسب هذه القدرة الفرق الطبيعي للتقويم والعمر المدني. أيام العمل والعطل تنتمي إلى أداة أخرى ولا تُطبَّق هنا.

هل يمكن أن تكون النتيجة سالبة؟

نعم. عندما يسبق تاريخ النهاية تاريخ البداية يحمل total_days وحقول السنوات والأشهر والأيام إشارة سالبة دون تبديل القيم المُرسلة.

هل الحاسبة مجانية على الحاسوب والجوال؟

تعمل الصفحة محلياً ومجاناً في متصفحات سطح المكتب والجوال. يستدعي التطبيق الأصلي واجهة البرمجة ويعرض التعرفة؛ نفس الطلب يكلف $0.002 من رصيد KIT المدفوع مسبقاً.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/dev/date-diff

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/dev/date-diff \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_from":"2024-01-31","date_to":"2024-02-29"}'

const res = await fetch("https://api.kit.forhosting.com/dev/date-diff", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date_from": "2024-01-31",
    "date_to": "2024-02-29"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/date-diff",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date_from": "2024-01-31",
    "date_to": "2024-02-29"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/date-diff", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date_from":"2024-01-31","date_to":"2024-02-29"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date_from":"2024-01-31","date_to":"2024-02-29"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/date-diff", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "date_from": "2024-01-31",
  "date_to": "2024-02-29"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.date_diff",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`year_min`	1
`year_max`	9999

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا