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

محدد ربع السنة

يقع 15 مايو 2024 في الربع الثاني، الذي يمتد من 1 أبريل إلى 30 يونيو 2024. أدخل أي تاريخ لتعرف ربعه التقويمي وأول يوم وآخر يوم فيه والأشهر الثلاثة التي يضمها. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-05-15

تحصل على

السنة: 2,024
الشهر: 5
اليوم: 15
ربع السنة: 2

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

كيف تُشتق أرباع السنة التقويمية من تاريخ ISO

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

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

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

لا تغيّر السنوات الكبيسة تواريخ نهاية الأرباع لأن فبراير ليس أبداً آخر شهر في ربع.

أين يظهر محدد ربع السنة في العمل الحقيقي

تسمّي فرق المالية والمحاسبة الفواتير والحجوزات وحزم مجلس الإدارة بربع السنة التقويمي حتى تتجمع التقارير السنوية بلا مفاتيح شهرية غامضة. يجدول مديرو المنتج معالم خريطة الطريق وOKR مقابل Q1 إلى Q4 ويحتاجون تواريخ البداية والنهاية الشاملة عند بناء المرشحات أو نوافذ التذكير. تقسّم مستودعات البيانات جداول الحقائق حسب الربع ويجب أن تختم كل صف مصدر برقم ربع مستقر مشتق من تاريخ مدني ISO لا من ساعة المضيف المحلية.

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

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

ما أرباع السنة التقويمية؟

Q1 من 1 يناير–31 مارس، وQ2 من 1 أبريل–30 يونيو، وQ3 من 1 يوليو–30 سبتمبر، وQ4 من 1 أكتوبر–31 ديسمبر. الحدود تواريخ مدنية لنفس سنة الإدخال.

هل تغيّر السنة الكبيسة تواريخ نهاية الربع؟

لا. فبراير ليس أبداً آخر شهر في ربع، لذا ينتهي Q1 في 31 مارس في السنوات الكبيسة والعادية. تؤثر قواعد الكبيسة فقط على كون 29 فبراير تاريخ إدخال صالحاً.

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

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

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

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

إلى أي ربع تنتمي الأيام الحدّية مثل 1 يناير أو 31 ديسمبر؟

ينتمي 1 يناير إلى الربع الأول و31 ديسمبر إلى الربع الرابع. ويبقى آخر يوم في أي ربع ضمن ذلك الربع، ولا ينزلق أبدًا إلى الربع التالي.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/quarter-of-year

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

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

curl -X POST https://api.kit.forhosting.com/date/quarter-of-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-05-15"}'

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

import os, requests

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

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

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

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

{
  "date": "2024-05-15"
}

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

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

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

كيف تُشتق أرباع السنة التقويمية من تاريخ ISO

المسار بأكمله حساب صحيح حتمي بلا بذور عشوائية وبلا طوابع ساعة حائط وبلا كائن Date في JavaScript وبلا استدعاءات شبكة، فالإدخالات المتطابقة تنتج دائماً نفس JSON.

ما الذي ترسله وما الذي تستقبله

أرسل حقلاً نصياً إلزامياً باسم date يحتوي يوماً تقويمياً ISO صارماً مثل 2024-05-15. الأيام التي تطابق النمط لكنها ليست تواريخ تقويم حقيقية، بما في ذلك التاسع والعشرين من فبراير خارج السنة الكبيسة وقيم الشهر خارج واحد إلى اثني عشر، تفشل أيضاً برسالة تسمي المشكلة حتى يصحح العملاء دون تخمين. فحوصات كلاسيكية: الخامس عشر من مايو يُسقط على Q2 بحدود الأول من أبريل حتى الثلاثين من يونيو؛ الأول من يناير على Q1؛ الحادي والثلاثون من ديسمبر على Q4؛ وحدود الأرباع نفسها تهبط على الكتلة الصحيحة دون الانزلاق إلى التالية. الحقول الناقصة والقيم غير النصية والسلاسل التي لا تطابق نمط أربعة-اثنين-اثنين أرقام تفشل بـ invalid_input ولا تُحاسب. عند النجاح تعيد الاستجابة سلسلة التاريخ المطبّعة ومكوّنات السنة والشهر واليوم الرقمية وquarter كعدد صحيح من واحد إلى أربعة وquarter_label كسلسلة Q1 إلى Q4 المألوفة وquarter_start وquarter_end كتواريخ ISO شاملة لذلك الكتلة المدنية وmonths_in_quarter كمصفوفة من ثلاثة أرقام أشهر وعلامة منطقية is_leap_year وسلسلة formula قصيرة توثّق قاعدة الشهر إلى الربع. تسعير استدعاءات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقاً.

أين يظهر محدد ربع السنة في العمل الحقيقي

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

حالات التكامل

التقارير المالية ومجلس الإدارة

أسقط كل تاريخ ISO لحجز أو فاتورة على Q1–Q4 مع quarter_start وquarter_end حتى تبقى التجميعات والمرشحات الربع سنوية متسقة بين الأدوات.

خرائط الطريق ونوافذ OKR

اختم المعالم بـ quarter_label وحدود شاملة حتى ترشّح لوحات المعلومات «الربع الحالي» دون مناطق زمنية للمضيف.

تقسيمات المستودع وتسميات الدفعات

اشتق رقم ربع مستقراً من إدخالات YYYY-MM-DD الصارمة لمفاتيح التقسيم، مع invalid_input واضح لأيام التقويم المستحيلة.

أسئلة تقنية

كم التكلفة؟

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

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

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

مثال محلول

كيف تُشتق أرباع السنة التقويمية من تاريخ ISO

أين يظهر محدد ربع السنة في العمل الحقيقي

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

كيف تُشتق أرباع السنة التقويمية من تاريخ ISO

ما الذي ترسله وما الذي تستقبله

أين يظهر محدد ربع السنة في العمل الحقيقي

حالات التكامل

التقارير المالية ومجلس الإدارة

خرائط الطريق ونوافذ OKR

تقسيمات المستودع وتسميات الدفعات

أسئلة تقنية

شكرًا