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

تاريخ بلوغ العمر المدور القادم

تحدد حاسبة تاريخ العمر المدور القادم اليوم التقويمي الذي يبلغ فيه الشخص، بعد التاريخ المرجعي، عمراً يقبل القسمة على عشرة مثل 30 أو 40 أو 50 أو 60 عاماً.

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

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

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

أدخلوا تاريخ ميلاد ISO وتاريخاً مرجعياً ISO بصورة صريحة، ولن تعتمد النتيجة على الساعة الحالية أو تخمين المنطقة الزمنية. تعرض الحاسبة العمر المكتمل عند التاريخ المرجعي، والعمر المدور القادم، وتاريخه الدقيق. تتبع جميع العمليات التقويم الغريغوري الاستباقي بتوقيت UTC، ولذلك تبقى استدعاءات API المتكررة حتمية ومناسبة للسجلات والحملات المجدولة واختبارات البرمجيات.

اختاروا تاريخاً مرجعياً صريحاً للحصول على نتيجة قابلة للتكرار

يتوقف موعد عيد الميلاد العشري القادم على الوقت الذي يُطرح فيه السؤال، ولذلك لا تستبدل هذه الحاسبة التاريخ المرجعي بتاريخ اليوم مطلقاً. قدموا birth_date وreference_date كتاريخين تقويميين كاملين بصيغة ISO وفق YYYY-MM-DD. يجب أن يساوي التاريخ المرجعي تاريخ الميلاد أو يأتي بعده. يُفسر التاريخان كيومين تقويميين وفق UTC، من دون إزاحة محلية أو تعديل للتوقيت الصيفي أو وقت حالي مخفي. وبذلك يكون الطلب المحفوظ قابلاً للتكرار: تعطي المدخلات نفسها النتيجة نفسها غداً أو من بلد آخر أو في بيئة اختبار. يتضمن الناتج المدخلات المتحقق منها، والعمر المكتمل عند المرجع، والمضاعف التالي للعدد عشرة، والتاريخ الذي يُبلغ فيه. استخدموا تاريخ الحدث المهني المعني، مثل يوم إعداد قائمة بريدية أو بدء مراجعة استحقاقات، بدلاً من الاعتماد على تاريخ المشغّل المحلي. يمنع ذلك عملية تُنفذ قرب منتصف الليل من تعيين تواريخ مختلفة للمرحلة العمرية باختلاف المناطق.

افهموا المقصود بالعمر المدور القادم

العمر المدور هو عمر موجب يقبل القسمة على عشرة. يحدد الحساب أولاً عدد السنوات التقويمية المكتملة عند التاريخ المرجعي، ثم يختار مضاعف العشرة الأكبر منه حصراً. فمن كان عمره 32 عاماً يتجه إلى 40، ومن كان عمره 9 أعوام يتجه إلى 10. وينطبق شرط الأكبر حصراً في يوم المرحلة نفسه أيضاً: إذا وافق المرجع عيد الميلاد الأربعين، كان العمر المدور القادم 50 لا 40، لأن سن 40 قد بُلغ بالفعل. تستخدم مقارنة عيد الميلاد الشهر واليوم بدلاً من متوسط عدد أيام السنة، فلا تسبب السنوات الكبيسة أو اختلاف أطوال الأشهر خطأ بسنة كاملة. يحتفظ التاريخ المستهدف بشهر الميلاد ويومه متى كان ذلك اليوم موجوداً. تغطي النتائج السنوات من 0001 إلى 9999 في التقويم الغريغوري الاستباقي. إذا أدى العمر المطلوب إلى تجاوز سنة 9999، يُرفض الطلب بدلاً من إرجاع تاريخ مبتور أو مختلق. تعتمد الطريقة على حساب صحيح للتقويم ولا تستخدم ساعة الجهاز أو العشوائية أو خدمة شبكية.

تعاملوا مع مواليد 29 فبراير بقاعدة موحدة

يحتاج تاريخ الميلاد في 29 فبراير إلى قاعدة صريحة لأن كثيراً من السنوات المستهدفة لا تحتوي ذلك اليوم. تعتبر هذه القدرة 28 فبراير ذكرى الميلاد في السنة غير الكبيسة، وتبقي 29 فبراير عندما تكون السنة المستهدفة كبيسة. تُستخدم القاعدة نفسها لتحديد العمر المكتمل عند المرجع وإنشاء تاريخ المرحلة التالية، ولذلك لا يتعارض الجزآن. هذه اتفاقية حسابية حتمية وليست تقريراً للقاعدة القانونية في كل ولاية قضائية؛ فقد تعتمد بعض القوانين أو البرامج 1 مارس بدلاً منها. إذا توقف استحقاق قانوني أو عقد أو إشعار منظم على عيد الميلاد، فتحققوا من القاعدة المطبقة قبل التصرف. أما التخطيط العام والتحليلات والتذكيرات وتقسيم CRM والاختبارات القابلة للتكرار، فتمنحها قاعدة 28 فبراير المعلنة نتيجة مستقرة. تتضمن الاستجابة حقل february_29_rule حتى لمواليد الأيام العادية، كي تسجل الأنظمة اللاحقة الاتفاقية من دون الرجوع إلى الوثائق. تبلغ كلفة كل طلب API مقدار $0.002، ولا يُرسل تاريخ الميلاد إلى أي طرف ثالث.

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

التخطيط لاحتفال بمرحلة عمرية

حوّلوا تاريخ ميلاد معروفاً إلى التاريخ الدقيق لعيد الميلاد العشري القادم لاستخدامه في الدعوات أو الميزانيات أو التذكيرات.

جدولة حملة CRM

احسبوا تاريخاً ثابتاً لسن 30 أو 40 أو مرحلة لاحقة انطلاقاً من مرجع الحملة نفسه ومن دون انحراف ساعة الخادم.

إنشاء اختبارات حتمية للتواريخ

اختبروا منطق أعياد الميلاد بمدخلات ISO ثابتة، بما في ذلك يوم المرحلة نفسه وحالات 29 فبراير الحدية.

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

ما المقصود بالعمر المدور القادم؟

هو أصغر مضاعف للعدد عشرة يكون أكبر حصراً من العمر المكتمل في التاريخ المرجعي.

ماذا يحدث في عيد الميلاد الأربعين؟

بما أن سن 40 قد بُلغ في ذلك اليوم، يكون العمر المدور القادم 50.

كيف تُعامل الولادة في 29 فبراير؟

يُستخدم 28 فبراير في سنوات الذكرى غير الكبيسة، ويُحتفظ بـ29 فبراير في السنوات الكبيسة.

هل تستخدم الحاسبة تاريخ اليوم؟

لا. يلزم تقديم reference_date، ولا يقرأ الحساب ساعة النظام مطلقاً.

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

تبلغ كلفة كل عنصر $0.002. والحساب نقي ولا يستخدم خدمة شبكية لطرف ثالث.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/next-round-age-day

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

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

curl -X POST https://api.kit.forhosting.com/date/next-round-age-day \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"1994-08-17","reference_date":"2026-08-13"}'

const res = await fetch("https://api.kit.forhosting.com/date/next-round-age-day", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "birth_date": "1994-08-17",
    "reference_date": "2026-08-13"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/next-round-age-day",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "birth_date": "1994-08-17",
    "reference_date": "2026-08-13"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/next-round-age-day", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"birth_date":"1994-08-17","reference_date":"2026-08-13"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"birth_date":"1994-08-17","reference_date":"2026-08-13"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/next-round-age-day", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "birth_date": "1994-08-17",
  "reference_date": "2026-08-13"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.next_round_age_day",
  "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 الكامل ←