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

طرح الأيام من تاريخ

أدخل تاريخًا وعددًا من الأيام واحصل على اليوم الأبكر بدقة: 15 مارس 2024 ناقص 10 أيام يساوي 5 مارس. تُعالَج نهايات الأشهر والسنوات الكبيسة وتغيّر السنة تلقائيًا. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-03-15
الأيام: 10

تحصل على

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

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

ماذا يعني طرح الأيام وماذا تحتوي الاستجابة

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

من الحالات المرفوضة: غياب حقل date أو days، أو صيغ خاطئة مثل 2024/03/15، أو أشهر مستحيلة، أو أيام غير موجودة مثل 2023-02-29، وأعداد أيام سالبة، ونتائج تقع سنتها خارج النافذة المدعومة من واحد إلى 9999. إن احتجت أيام العمل، أو تحويل الحقبة الزمنية، أو التحليل متعدّد الصيغ، أو أرقام أسابيع ISO، فاستخدم الأدوات المخصّصة لذلك؛ هذه الصفحة تجيب فقط عن التاريخ الميلادي الأبكر بعد طرح أيام كاملة من أساس ISO مُتحقَّق منه.

أين يفيد حساب التاريخ الأبكر في التخطيط والامتثال والبرمجيات

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

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

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

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

نوافذ السياسة والإشعار

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

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

تحقّق من أن 1 مارس ناقص يوم واحد يقع في 29 فبراير في السنوات الكبيسة فقط، وأن حدود السنوات تتراجع بشكل صحيح إلى ديسمبر السابق.

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

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

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

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

يطرح المحرك عددًا صحيحًا غير سالب من الأيام التقويمية الميلادية من أساس YYYY-MM-DD مُتحقَّق منه باستخدام حساب أيام تسلسلي بحت. لا تُتخطّى عطلات نهاية الأسبوع أو العطلات الرسمية.

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

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

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

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

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

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

هل تتخطى الحاسبة عطلات نهاية الأسبوع والأعياد؟

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

أدوات ذات صلة

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

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

الـEndpoint

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

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

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

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

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2024-03-15","days":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/subtract-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-15",
  "days": 10
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`year_min`	1
`year_max`	9999
`days_min`	0
`days_max`	3652430

الأخطاء

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

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

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

ماذا يعني طرح الأيام وماذا تحتوي الاستجابة

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

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

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

أين يفيد حساب التاريخ الأبكر في التخطيط والامتثال والبرمجيات

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

أسئلة تقنية

كم تكلّف حاسبة طرح الأيام من تاريخ؟

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

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

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

مثال محلول

ماذا يعني طرح الأيام وماذا تحتوي الاستجابة

أين يفيد حساب التاريخ الأبكر في التخطيط والامتثال والبرمجيات

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

نوافذ السياسة والإشعار

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

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

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

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

ماذا يعني طرح الأيام وماذا تحتوي الاستجابة

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

أين يفيد حساب التاريخ الأبكر في التخطيط والامتثال والبرمجيات

أسئلة تقنية

شكرًا