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

حاسبة العمر بالثواني الإجمالية

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

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

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

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

تفيد حين تكون السنوات والأشهر والأيام وحدات تقريبية أكثر من اللازم لعدّاد أو مناسبة أو حقل بيانات أو مقارنة. أدخلوا تاريخين وفق التقويم الميلادي بصيغة YYYY-MM-DD. تتحقق الحاسبة من صحتهما، وتحسب كل الأيام المنقضية بما فيها الأيام الكبيسة، ثم تضرب العدد في ثواني اليوم الواحد.

اختاروا تاريخ الميلاد والتاريخ المرجعي

ابدؤوا بتاريخ الميلاد، ثم اختاروا اليوم الذي تريدون قياس العمر عنده. يستخدم التاريخان الصيغة الصارمة YYYY-MM-DD؛ فمثلًا يُكتب 9 مارس 1992 على النحو 1992-03-09. يمكن أن يكون التاريخ المرجعي تاريخ اليوم إذا أرسله تطبيقكم صراحة، أو تاريخًا ماضيًا لحساب تاريخي، أو تاريخًا مستقبليًا لمناسبة مخطط لها. لا تقرأ الحاسبة الساعة الحالية أبدًا، ولذلك تظل الطلبات المتكررة مستقرة ويمكن تدقيق كل نتيجة. يُعامل كل تاريخ على أنه منتصف الليل بتوقيت UTC. وهذه القاعدة مهمة لأن التاريخ التقويمي وحده لا يحدد ساعة من اليوم ولا منطقة زمنية. يجب أن يساوي التاريخ المرجعي تاريخ الميلاد أو يأتي بعده. فإذا سبقه، تُرفض المدخلات بدلًا من إرجاع عمر سالب. كما تُرفض التواريخ المستحيلة مثل 2025-02-29 أو 2024-13-01، وبذلك لا ينتج مجموع يبدو معقولًا من قيمة تقويمية غير موجودة.

افهموا طريقة حساب الثواني الإجمالية

يحوّل الحساب أولًا كل تاريخ ميلادي صحيح إلى رقم يوم متسلسل باستخدام حسابات تقويمية بالأعداد الصحيحة. ثم يطرح رقم يوم الميلاد من رقم اليوم المرجعي، ويضرب الفرق في 86,400، وهو العدد الدقيق لثواني SI في يوم تقليدي مدته أربع وعشرون ساعة. تُطبّق قواعد السنوات الكبيسة في التقويم الميلادي مباشرة: تكون السنة القابلة للقسمة على أربعة كبيسة، باستثناء سنوات القرون ما لم تكن قابلة للقسمة على أربعمائة أيضًا. لذلك يضيف 29 فبراير يومًا حين يقع فعلًا داخل الفترة. تتضمن النتيجة total_days بوصفه قيمة وسيطة قابلة للمراجعة، وtotal_seconds بوصفه الجواب الأساسي. ولأن المدخلات تواريخ وليست طوابع زمنية، تُستبعد أجزاء اليوم عمدًا. ولا تستنتج الحاسبة انتقالات التوقيت الصيفي أو فروق المناطق المحلية أو الثواني الكبيسة أو ساعة الميلاد. وهكذا تقدّم قياسًا مدنيًا حتميًا مناسبًا للحاسبات والسجلات، من دون ادعاء دقة لا توفرها المدخلات.

استخدموا النتيجة بدقة في التطبيقات والمناسبات

استخدموا total_seconds عندما تحتاجون إلى قيمة عددية واحدة قابلة للمقارنة بدلًا من عبارة عمر بوحدات التقويم. يمكن لصفحة احتفالية تحديد اللحظة التي يبلغ فيها شخص محطة كبيرة من الثواني التي عاشها؛ ويمكن لتمرين دراسي مقارنة الأعمار بوحدة موحدة؛ كما يستطيع مسار معالجة بيانات توحيد الأعمار المستخرجة من التواريخ قبل ترتيب السجلات أو تحليلها. احتفظوا بالحقلين birth_date وreference_date بجوار المجموع كي يستطيع القارئ إعادة الحساب لاحقًا. إذا كان نظام المصدر يخزن طابعًا زمنيًا دقيقًا للميلاد، فلا تحل هذه الحاسبة القائمة على التاريخ وحده محل طرح الطوابع الزمنية؛ فهي تقيس عمدًا من منتصف الليل UTC في تاريخ إلى منتصف الليل UTC في التاريخ الآخر. كذلك لا ينبغي تفسير الناتج على أنه زمن ذري منقضٍ، لأن التقاويم المدنية لا تسجل الثواني الكبيسة التاريخية. ولحسابات العمر بالثواني والعدادات القائمة على التاريخ، تظل القاعدة متسقة وثابتة. الحساب مجاني في المتصفح، أما طلب API الآلي فيستخدم السعر الأساسي المعروض $0.002 ويعيد النتيجة الحتمية نفسها.

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

الاحتفال بمحطة من الثواني المعاشة

حوّلوا المدة بين الميلاد وحدث ما إلى رقم واحد يصلح لبطاقة مناسبة أو عدّاد أو إعلان.

توحيد الأعمار لأغراض التحليل

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

تعليم الحسابات التقويمية

وضّحوا العلاقة بين السنوات العادية والكبيسة والأيام المنقضية والثواني باستخدام تواريخ قابلة لإعادة الحساب.

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

ما الذي تعيده الحاسبة؟

تعيد تاريخي الميلاد والمرجع بعد التحقق منهما، وإجمالي الأيام المنقضية، وإجمالي الثواني.

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

نعم. تطبق قواعد التقويم الميلادي، بما فيها استثناء سنوات القرون واستثناء السنوات القابلة للقسمة على أربعمائة.

هل تستخدم تاريخ اليوم تلقائيًا؟

لا. يجب أن تقدموا التاريخ المرجعي، كي تعطي المدخلات نفسها النتيجة نفسها دائمًا.

هل تدخل الساعة والمنطقة الزمنية في الحساب؟

لا. يُفسر التاريخان على أنهما منتصف الليل UTC، وتُحوّل الأيام الكاملة إلى ثوانٍ.

هل يمكن أن يسبق التاريخ المرجعي تاريخ الميلاد؟

لا. يُرفض هذا الترتيب كمدخل غير صالح بدلًا من إظهار عمر سالب.

ما تكلفة الحساب عبر API؟

يستخدم كل طلب API السعر الأساسي المعروض $0.002؛ أما التشغيل في المتصفح فمجاني.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/age-total-seconds

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

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

curl -X POST https://api.kit.forhosting.com/date/age-total-seconds \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"2000-01-01","reference_date":"2025-01-01"}'

const res = await fetch("https://api.kit.forhosting.com/date/age-total-seconds", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "birth_date": "2000-01-01",
    "reference_date": "2025-01-01"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/age-total-seconds",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "birth_date": "2000-01-01",
    "reference_date": "2025-01-01"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/age-total-seconds", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"birth_date":"2000-01-01","reference_date":"2025-01-01"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"birth_date":"2000-01-01","reference_date":"2025-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/age-total-seconds", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "birth_date": "2000-01-01",
  "reference_date": "2025-01-01"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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