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

بداية ونهاية الربع

يمتد الربع الأول من 2026 من 1 يناير إلى 31 مارس 2026. اختر سنة وربعًا من 1 إلى 4 لتحصل على أول يوم وآخر يوم بدقة، جاهزين لفلاتر التقارير ولوحات المتابعة وقوائم إقفال الفترات. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

السنة: 2,026
الربع: 1

تحصل على

تسمية الربع: Q1
الأشهر: January–March
تاريخ البداية: 2026-01-01
تاريخ النهاية: 2026-03-31

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

ما هو ربع التقويم وكيف ترسلون السنة والربع

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

تعيد الاستجابة دائمًا السنة والربع المُطبَّعين حتى يسجل العملاء ما حُلّ بالضبط. استخدموا هذه الأداة عندما تحتاجون التعريف العام للتقويم من Q1 إلى Q4، لا سنة مالية مخصصة تبدأ في يوليو ولا تقويم تجزئة 4-4-5.

متى تستخدم حدود الربع وما الذي لا تغطيه

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

لا يحوّل هذا المنتج إزاحات السنة المالية ولا أرباع أسبوع ISO ولا أنصاف السنوات —فتلك نيات بحث مختلفة— فابقوا المنطق المالي المخصص في طبقتكم واستدعوا هذه القدرة فقط لـ Q1 إلى Q4 التقويمية القياسية.

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

منتقيات التواريخ في تحليلات المنتج

تملأ لوحات التحكم مسبقًا ضوابط نطاق الربع من السنة ورقم الربع حتى ينتقل المستخدمون إلى «هذا الربع» أو «Q4 العام الماضي» دون حساب يدوي.

تصديرات مجدولة ومهام cron

تمرّر مهام الدفعات سنة وربعًا للحصول على حدود ISO مستقرة لمستخرجات CSV وأقسام المستودع ونوافذ الاحتفاظ المثبتة في تجهيزات CI.

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

ماذا يحدث إذا كان الربع خارج 1 إلى 4؟

تُدعم أرباع التقويم Q1 إلى Q4 فقط؛ تُرفض قيم مثل 0 أو 5 ولا تُحسب.

هل هذه أرباع مالية أم تقويمية؟

تقويمية فقط: Q1 يناير–مارس، Q2 أبريل–يونيو، Q3 يوليو–سبتمبر، وQ4 أكتوبر–ديسمبر. التقاويم المالية المخصصة خارج النطاق.

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

لا. بموجب جدول أرباع التقويم الغريغوري المستخدم هنا، يبدأ كل ربع وينتهي عند أزواج شهر-يوم ثابتة لا تعتمد على 29 فبراير.

هل يدخل تاريخا البداية والنهاية ضمن الربع؟

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

ما الأشهر التي يغطيها كل ربع؟

يمتد الأول من يناير إلى مارس، والثاني من أبريل إلى يونيو، والثالث من يوليو إلى سبتمبر، والرابع من أكتوبر إلى ديسمبر. وينتهي كل ربع دائمًا في آخر يوم من شهره الثالث، أيًّا كانت السنة.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/quarter-start-end

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

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

curl -X POST https://api.kit.forhosting.com/date/quarter-start-end \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"quarter":1}'

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

import os, requests

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

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

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

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

{
  "year": 2026,
  "quarter": 1
}

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

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

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

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

ما هو ربع التقويم وكيف ترسلون السنة والربع

أرسلوا الحقل الإلزامي year كعدد صحيح JSON أو سلسلة عدد صحيح بين واحد وتسعة آلاف وتسعمائة وتسعة وتسعين؛ تُقبل الأسماء البديلة y وyr. أرسلوا الحقل الإلزامي quarter كعدد صحيح من واحد إلى أربعة؛ تُقبل الأسماء البديلة q وqtr. الحقول الناقصة وغير الأعداد الصحيحة والقيم خارج النطاق ترفع invalid_input حتى تفشل المسارات بسرعة دون تخمين. تنتج الطلبات المتطابقة دائمًا JSON متطابقًا لأن المسار حساب خالص واستعلام جدول بلا كائن Date وبلا بذرة عشوائية وبلا خدمة بعيدة.

قراءة start_date وend_date وحقول الربع المنظمة

لا تغيّر السنوات الكبيسة تواريخ بداية أو نهاية الربع بموجب هذا العقد، لأن أي حد للربع لا يقع في التاسع والعشرين من فبراير؛ الحادي والثلاثون من مارس والثلاثون من يونيو والثلاثون من سبتمبر والحادي والثلاثون من ديسمبر ثابتة. تفشل السنة خارج الحد الأدنى والأقصى المنشورين بنفس الطريقة حتى لا يخترع فيض صامت تاريخًا. عند النجاح تتضمن الاستجابة year وquarter وquarter_label مثل Q2، وسلسلة أشهر مقروءة مثل أبريل–يونيو، والسلسلتين الأساسيتين start_date وend_date بصيغة YYYY-MM-DD مع شهر ويوم مملوءين بالأصفار. هذه السلاسل شاملة: كل يوم من البداية حتى النهاية ينتمي إلى الربع. تُعاد نفس الحدود أيضًا كأعداد صحيحة start_month وstart_day وend_month وend_day حتى تربط صيغ الجداول ومنتقيات التواريخ في الواجهة دون إعادة تحليل سلاسل ISO. حقل calendar دائمًا gregorian وmethod دائمًا calendar_quarter حتى يتفرع الكود اللاحق دون فحص الأشكال. استخدموا start_date وend_date وحدهما لعبارات SQL BETWEEN ومرشحات تاريخ API؛ واستخدموا حقول الشهر واليوم الرقمية عند بناء تقارير متعددة الأعمدة؛ واستخدموا quarter_label عندما تحتاج أسطورة مخطط شارة قصيرة. يفشل الربع خارج واحد إلى أربعة بـ invalid_input يذكر نطاق الربع ولا يُحسب.

استخدام API والتسعير ومسارات التقارير والحدود العملية

أرسلوا جسم JSON بالعدد الصحيح الإلزامي year والعدد الصحيح الإلزامي quarter من واحد إلى أربعة. استخدموا API المدفوعة مسبقًا عندما يحتاج مسار فوترة أو استخراج BI أو مهمة cron أو لوحة SaaS عقدًا مستقرًا تحت رصيد KIT بسعر $0.002 لكل عنصر ناجح؛ ولا تستهلك إخفاقات التحقق الرصيد بعد رفض المحرك. يمكن لمؤلفي SDK ربط start_date وend_date مباشرة بضوابط نطاق التواريخ، وquarter_label بعناوين مثل Q3 2026.

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

نوافذ التقارير المالية

تحل أدوات المراقبة وFP&A نطاقات Q1–Q4 الشاملة لسنة معينة ثم تغذي start_date وend_date في مرشحات الدفاتر وقوائم الإغلاق وحزم مجلس الإدارة.

أسئلة تقنية

كيف أحصل على تواريخ بداية ونهاية الربع؟

أرسلوا JSON مع year (مثل 2026) وquarter من 1 إلى 4. تتضمن الاستجابة start_date وend_date بصيغة YYYY-MM-DD مع حقول شهر ويوم منظمة.

هل حاسبة بداية ونهاية الربع مجانية؟

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

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

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

مثال محلول

ما هو ربع التقويم وكيف ترسلون السنة والربع

متى تستخدم حدود الربع وما الذي لا تغطيه

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

منتقيات التواريخ في تحليلات المنتج

تصديرات مجدولة ومهام cron

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

ما هو ربع التقويم وكيف ترسلون السنة والربع

قراءة start_date وend_date وحقول الربع المنظمة

استخدام API والتسعير ومسارات التقارير والحدود العملية

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

نوافذ التقارير المالية

أسئلة تقنية

شكرًا