ForHosting KIT · التواريخ والوقت

إضافة أشهر إلى تاريخ

أضف أشهرًا كاملة إلى تاريخ واحصل على اليوم اللاحق في التقويم: 31 يناير 2024 مضافًا إليه شهر واحد هو 29 فبراير 2024، لأن اليوم غير الموجود ينتقل إلى آخر يوم في الشهر. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-01-31
الأشهر: 1

تحصل على

النتيجة: 2024-02-29
السنة: 2,024
الشهر: 2
اليوم: 29

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

ماذا تعني إضافة الأشهر وماذا تحتوي الاستجابة

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

حالات نهاية الشهر الكلاسيكية صريحة: 31 يناير زائد شهر يصبح 28 أو 29 فبراير حسب السنة الكبيسة، و31 مارس زائد شهر يصبح 30 أبريل، و31 مايو زائد شهر يصبح 30 يونيو. من الحالات المرفوضة: غياب حقل date أو months، أو صيغ خاطئة مثل 2024/01/31، أو أشهر مستحيلة، أو أيام غير موجودة مثل 2023-02-29، وأعداد أشهر سالبة، ونتائج تقع سنتها خارج النافذة المدعومة من واحد إلى 9999.

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

أين تفيد التواريخ المُزاحة بالشهر في الفوترة والتجديدات والبرمجيات

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

يستدعي المطوّرون العقد من النصوص البرمجية لتوليد متجهات اختبار حتمية للمُجدوِلات، أو لعرض بيانات لفترات الرواتب والتجربة، أو لتلبية متطلّبات منتج تتطلّب خطوة شهر تقويمي بحتة دون انحراف منطقة زمنية ودون المفاجآت التي تنتجها بعض مكتبات Date عند تقديم 31 يناير. يستخدم المعلّمون وكاتبو المعايير الأداة لعرض سلوك التثبيت مثل 2024-01-31 زائد شهر في سنة كبيسة مقابل 2023-01-31 زائد شهر في سنة عادية دون الاعتماد على أرقام تسلسلية لجداول البيانات تختلف بين المنتجات.

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

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

دورات الاشتراك والفوترة

اعرض تاريخ التجديد أو استحقاق الفاتورة التالي بعد N شهرًا من تاريخ إصدار مُتحقَّق منه، مع تثبيت أيام نهاية الشهر بشكل صحيح.

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

تحقّق من أن 31 يناير زائد شهر واحد يقع في 29 فبراير في السنوات الكبيسة فقط، وفي 28 فبراير في السنوات العادية، دون غرابات Date.

بيانات اختبار حتمية

أنشئ سلاسل ISO مُزاحة بالشهر قابلة لإعادة الإنتاج لاختبارات الوحدة وفحوص الخصائص وتأكيدات التكامل المستمر دون الاعتماد على Date أو ساعة الجهاز.

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

كيف يُحدَّد التاريخ اللاحق؟

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

ماذا يحدث مع نهايات الأشهر والسنوات الكبيسة؟

تُتحقَّق أطوال الأشهر والأيام الكبيسة وتُطبَّق. مثلًا 2024-01-31 زائد شهر واحد هو 2024-02-29، بينما 2023-01-31 زائد شهر واحد هو 2023-02-28. حقل clamped يكون صحيحًا حين يُختزَل اليوم.

ما صيغ التاريخ وقيم الأشهر المقبولة؟

فقط تواريخ تقويمية صارمة بصيغة YYYY-MM-DD للأساس، وقيمة months صحيحة من 0 إلى 119988.

هل تحوّل هذه الأداة المناطق الزمنية أو تستخدم الساعة الحالية؟

لا. تُطابِق فقط تاريخًا تقويميًّا مُتحقَّقًا منه مع N شهرًا كاملًا بحساب حسابي بحت. لا يوجد كائن Date، ولا إزاحة منطقة زمنية، ولا اعتماد على «اليوم».

هل يمكن طرح أشهر من التاريخ؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/add-months

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

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

curl -X POST https://api.kit.forhosting.com/date/add-months \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-31","months":1}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/add-months",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-01-31",
    "months": 1
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "date": "2024-01-31",
  "months": 1
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`year_min`	1
`year_max`	9999
`months_min`	0
`months_max`	119988

الأخطاء

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

ملاحظات تقنية

استخدمها مجانًا في المتصفح لدورات الفوترة والتجديدات والواجبات المدرسية، أو استدعِ واجهة برمجة التطبيقات مقابل $0.002 لكل طلب ناجح حين تحتاج بيانات ثابتة لإزاحة الأشهر قابلة لإعادة الإنتاج في التكامل المستمر أو خطوط أنابيب التقارير أو ميزات المنتج.

ماذا تعني إضافة الأشهر وماذا تحتوي الاستجابة

تتحقّق الحاسبة من أن يوم الأساس يوم تقويمي حقيقي — 29 فبراير فقط في السنوات الكبيسة، وثلاثون يومًا في أبريل، ولا يوم اثنين وثلاثين مطلقًا — ثم تُرجع تاريخ الأساس المُطبَّع، وعدد months المستخدم، والنتيجة اللاحقة result بصيغة YYYY-MM-DD، وحقول السنة والشهر واليوم للنتيجة، وقيمة منطقية clamped تكون صحيحة حين يُختزَل اليوم، وdays_in_result_month لطول الشهر الهدف، ومكوّنات الأساس base_year وbase_month وbase_day لتسهيل التمرير إلى أدوات أخرى، وتذكيرًا مختصرًا بالصيغة. لا توجد بداية أسبوع تعتمد على المنطقة، ولا تقريب عائم لطول الشهر بالأيام، ولا اعتماد على كائن Date في الجهاز: فإما أن يكون الإدخال يومًا تقويميًّا حقيقيًّا بعدد أشهر ضمن النطاق ويكون التاريخ اللاحق محدَّدًا تمامًا، أو يفشل الطلب برمز invalid_input.

كيف تُقرأ التاريخ وعدد الأشهر وكيف تبقى النتيجة قابلة لإعادة الإنتاج

يجب أن تطابق السلسلة أربعة أرقام، ثم شرطة، ثم رقمَين، ثم شرطة أخرى، ثم رقمَين؛ تُزال المسافات البادئة أو اللاحقة، لكن التواريخ الجزئية أو يوم السنة الترتيبي وحده أو أسماء الأشهر لا تُوسَّع هنا. بعد التحليل، يجب أن تقع السنة بين 1 و9999، والشهر بين 1 و12، واليوم بين 1 والطول الحقيقي لذلك الشهر في تلك السنة، مع اتّباع السنوات الكبيسة قاعدة الميلادي: القابلية للقسمة على أربعة إلا سنوات القرن غير القابلة للقسمة على أربعمئة. داخليًّا يحوّل المحرك السنة والشهر المدنيَّين إلى فهرس شهر يبدأ من صفر بصيغة السنة ضرب اثني عشر زائد الشهر ناقص واحد، ويضيف عدد الأشهر الصحيح، ثم يستخرج السنة والشهر الهدف ويثبّت اليوم الأصلي عند عدد أيام ذلك الشهر الهدف — حساب أعداد صحيحة بحت مستقر بتًّا للبت عبر بيئات التشغيل. الحقل المفضّل للأساس هو date، لكن الأسماء البديلة iso_date وd وvalue وbase مقبولة كي تستطيع جداول البيانات وسلاسل الاستعلام والنماذج المُكتَّبة إعادة استخدام العقد نفسه دون إعادة تسمية الأعمدة. حقل months، بأسماء بديلة n وcount وadd، يجب أن يكون عددًا صحيحًا من 0 حتى 119988؛ تُقبل علامة الجمع الاختيارية في بداية سلاسل الأرقام، بينما تُرفض الكسور العشرية والأعداد السالبة والرموز غير الرقمية برسالة واضحة كي لا تتحوّل خلية خاطئة إلى تاريخ لاحق خاطئ. اقرن التشغيل المجاني في المتصفح بالواجهة البرمجية المدفوعة حين تحتاج التاريخ المُزاح بالشهر نفسه داخل خط أنابيب آلي.

أين تفيد التواريخ المُزاحة بالشهر في الفوترة والتجديدات والبرمجيات

تعمل هذه الصفحة كليًّا داخل متصفحك؛ وعبر الواجهة البرمجية يكلّف كل استعلام ناجح $0.002، ولا تُحتسب رسوم على التحقّق الفاشل، ولا يُحفَظ شيء بعد إعادة الاستجابة. هذا الفصل — استكشاف تفاعلي مجاني وواجهة برمجية مدفوعة مطابقة له — يواكب بقية كتالوج الفئة A في KIT، ويتيح لك الانتقال من فحص لمرّة واحدة إلى خط أنابيب دون أن تتغيّر النتيجة الرياضية.

أسئلة تقنية

كم تكلّف حاسبة إضافة الأشهر إلى تاريخ؟

هي مجانية في متصفحك على هذه الصفحة. عبر الواجهة البرمجية يكلّف الطلب الناجح $0.002؛ ولا تُحتسب رسوم على المدخلات غير الصالحة.

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

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

مثال محلول

ماذا تعني إضافة الأشهر وماذا تحتوي الاستجابة

أين تفيد التواريخ المُزاحة بالشهر في الفوترة والتجديدات والبرمجيات

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

دورات الاشتراك والفوترة

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

بيانات اختبار حتمية

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

ماذا تعني إضافة الأشهر وماذا تحتوي الاستجابة

كيف تُقرأ التاريخ وعدد الأشهر وكيف تبقى النتيجة قابلة لإعادة الإنتاج

أين تفيد التواريخ المُزاحة بالشهر في الفوترة والتجديدات والبرمجيات

أسئلة تقنية

شكرًا