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

إضافة أرباع سنة إلى تاريخ مع ضبط نهاية الشهر

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

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

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

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

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

معنى إضافة أرباع السنة التقويمية

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

آلية التحقق وضبط نهاية الشهر

تتحقق الحاسبة أولًا من وجود أربعة أرقام للسنة ورقمين للشهر ورقمين لليوم تفصل بينها شرطات. ثم تتحقق من التقويم الغريغوري الفعلي: يجب أن يكون الشهر بين 01 و12، وأن يلائم اليوم شهره، ولا يُقبل 29 فبراير إلا في سنة تقبل القسمة على أربعة، مع استثناء السنوات المئوية التي لا تقبل القسمة على أربعمئة. تحول الخوارزمية السنة والشهر إلى فهرس شهري صحيح، وتضرب عدد الأرباع ذي الإشارة في ثلاثة، ثم تضيف الإزاحة وتستعيد سنة الوجهة وشهرها. بعد ذلك تقارن اليوم الأصلي بعدد أيام شهر الوجهة. إن كان صالحًا أبقته، وإلا استخدمت آخر يوم وجعلت clamped مساويًا لـ true. فمثلًا يصل 30 نوفمبر بعد ربع واحد إلى 28 فبراير في السنة العادية أو 29 فبراير في السنة الكبيسة. تُرفض أي إزاحة تخرج نتيجتها عن السنوات من 0001 إلى 9999. تستخدم جميع الخطوات أعدادًا صحيحة محدودة، ولا تنشئ Date ولا تقرأ ساعة أو أسماء أشهر محلية أو قواعد منطقة زمنية تعتمد على بيئة التنفيذ.

الاستخدامات العملية والتكامل القابل للتكرار

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

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

تخطيط التجديدات ربع السنوية

قدموا تاريخ عقد أو ذكرى اشتراك فترة واحدة أو أكثر من ثلاثة أشهر مع سلوك واضح لنهاية الشهر.

مقارنات التقارير

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

بيانات اختبار التقويم

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

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

ما مدة ربع السنة في هذه الحاسبة؟

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

هل يمكن طرح أرباع السنة؟

نعم. أدخلوا عددًا صحيحًا سالبًا في quarters للرجوع إلى الخلف. يجب أن تبقى النتيجة بين السنتين 0001 و9999.

ماذا يحدث إذا لم يتضمن شهر الوجهة اليوم الأصلي؟

يُضبط اليوم إلى آخر يوم صالح في شهر الوجهة، ويصبح حقل clamped في الاستجابة مساويًا لـ true.

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

لا. يعتمد على تاريخ صريح وحساب صحيح حتمي، من دون Date أو ساعة أو تحويل منطقة زمنية.

ما تكلفة طلب API؟

التنفيذ في المتصفح مجاني. يكلف طلب API الناجح $0.002، وتُرفض المدخلات غير الصحيحة أو الخارجة عن النطاق.

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

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

الـEndpoint

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

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

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

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

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

import os, requests

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

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

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

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

{
  "date": "2024-11-30",
  "quarters": 1
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`year_min`	1
`year_max`	9999
`quarters_min`	-39996
`quarters_max`	39996

الأخطاء

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

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