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

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

أضف عددًا من الأيام التقويمية إلى تاريخ أو اطرحه منه واحصل على التاريخ الناتج بدقة: 1 مارس 2024 مضافًا إليه 10 أيام هو 11 مارس 2024. وتُراعى السنوات الكبيسة وأطوال الأشهر تلقائيًا. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-03-01
الأيام المضافة: 10

تحصل على

التاريخ الناتج: 2024-03-11
السنة: 2,024
الشهر: 3
اليوم: 11

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

كيف تعمل إضافة أيام التقويم دون ساعة

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

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

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

ما الذي ترسله وما الذي تسترجعه

أرسل حقلين مطلوبين: date كيوم تقويم ISO صارم مثل ألفين وأربعة وعشرين شرطة صفر ثلاثة شرطة صفر واحد، وdays كعدد صحيح محدود من الأيام مثل عشرة أو صفر أو سالب سبعة.

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

أين تظهر حاسبات إضافة الأيام في العمل الفعلي

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

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

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

استحقاقات الفواتير والاشتراكات

أضف خمسة عشر أو ثلاثين يومًا تقويميًا صافيًا إلى تاريخ فاتورة ISO لإنتاج استحقاق مستقر عبر المناطق الزمنية والمضيفين.

التذكيرات والمتابعات

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

نوافذ الاحتفاظ والتجربة

اشتق نهايات التجربة وعتبات الاحتفاظ من سلسلة ISO للبداية زائد إزاحة أيام صحيحة مضبوطة لخطوط الأنابيب وتجهيزات ضمان الجودة.

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

ماذا تعني إضافة أيام إلى تاريخ؟

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

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

نعم. تُطبَّق قواعد الكبيس الغريغورية: قابلة للقسمة على 4، باستثناء القرون التي يجب أن تكون قابلة للقسمة على 400. يُقبل 29 شباط فقط في السنوات الكبيسة ويُعبر بشكل صحيح عندما تقع الإزاحة على ذلك اليوم أو بعده.

ما تنسيق التاريخ المطلوب؟

ISO صارم YYYY-MM-DD بسنة من أربعة أرقام وشهر ويوم من رقمين. تُرفض قيم مثل 2024-3-1 أو 2024/03/01 حتى يتفق كل عميل على السلسلة ذاتها.

ماذا يحدث مع تاريخ أساس غير صالح مثل 2023-02-29؟

يوضح رسالة الخطأ أن اليوم غير صالح لتلك السنة وذلك الشهر.

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

نعم. أدخل عددًا سالبًا للرجوع إلى الوراء، مثل سالب 7 للعودة أسبوعًا كاملًا. وإذا أدخلت صفرًا يعود التاريخ نفسه دون تغيير.

أدوات ذات صلة

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

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

الـEndpoint

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

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

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

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

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

import os, requests

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

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

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

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

{
  "date": "2024-03-01",
  "days": 10
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.add_days",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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

ما الذي ترسله وما الذي تسترجعه

الحقول الناقصة، والتواريخ غير النصية، والسلاسل التي لا تطابق نمط الأرقام أربعة-اثنين-اثنين، وإزاحات الأيام غير الصحيحة، والأسس التي تطابق النمط لكنها ليست تواريخ تقويم حقيقية تفشل جميعها بـinvalid_input ولا تُحاسب. عند النجاح تعيد الاستجابة تاريخ الأساس المطبّع، وإزاحة days الصحيحة المطبّقة، وسلسلة ISO result بعد الجمع، والسنة والشهر واليوم الرقمية للنتيجة، وعلمًا منطقيًا is_leap_year لسنة النتيجة، وسلسلة formula قصيرة توثّق قاعدة الكبيس. تسعير استدعاءات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ ولا تستهلك إخفاقات التحقق الرصيد المدفوع مسبقًا.

أين تظهر حاسبات إضافة الأيام في العمل الفعلي

ولأن هذه القدرة محرك parse نقي، فإن تسعير API هو القاعدة المنشورة $0.002 لكل عنصر ناجح، ولا يستهلك فشل التحقق الرصيد.

أسئلة تقنية

كم التكلفة؟

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

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

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

مثال محلول

كيف تعمل إضافة أيام التقويم دون ساعة

ما الذي ترسله وما الذي تسترجعه

أين تظهر حاسبات إضافة الأيام في العمل الفعلي

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

استحقاقات الفواتير والاشتراكات

التذكيرات والمتابعات

نوافذ الاحتفاظ والتجربة

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

ما الذي ترسله وما الذي تسترجعه

أين تظهر حاسبات إضافة الأيام في العمل الفعلي

أسئلة تقنية

شكرًا