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

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

أدخل تاريخًا لتعرف في أي أسبوع من ربعه يقع: 20 مايو 2026 في الأسبوع 8 من الربع الثاني، محسوبًا من 1 أبريل. والأسبوع 1 هو دائمًا الأيام السبعة الأولى من الربع. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2026-05-20

تحصل على

السنة: 2,026
الربع: 2
بداية الربع: 2026-04-01
رقم الأسبوع: 8

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

تعريف رقم الأسبوع داخل الربع

تستخدم هذه الحاسبة الأرباع الميلادية وكتلاً من سبعة أيام تبدأ من أول الربع. يبدأ Q1 في 1 يناير وQ2 في 1 أبريل وQ3 في 1 يوليو وQ4 في 1 أكتوبر. تنتمي التواريخ السبعة الأولى إلى الأسبوع 1، والسبعة التالية إلى الأسبوع 2، ثم يستمر النمط.

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

قد يكون الأسبوع الأخير أقصر من سبعة أيام، وقد تبلغ بعض الأرباع الأسبوع 14. وتطبق قواعد السنة الكبيسة الغريغورية كاملة، بما فيها استثناءات سنوات القرون.

إرسال التاريخ والتحقق منه

أرسلوا الحقل date بصيغة ISO الصارمة YYYY-MM-DD، مثل 2026-05-20. يرفض النص الإضافي والصيغ المحلية والطوابع الزمنية والأصفار الابتدائية الناقصة بدلاً من تخمينها. يجب أن تكون السنة بين 0001 و9999، والشهر بين 01 و12، وأن يكون اليوم موجوداً فعلاً في ذلك الشهر.

لا تستخدم القدرة Date في JavaScript ولا منطقة الجهاز الزمنية ولا ساعة النظام. تتحقق من المكونات الرقمية ثم تنفذ حساباً صحيحاً محدوداً، ولذلك تعطي إعادة الطلب المحفوظ النتيجة نفسها.

استخدام النتيجة في التقارير والأتمتة

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

تقيس القدرة أيام التقويم لا أيام العمل؛ فلا تستثني العطلات أو نهايات الأسبوع، ولا تفرض الاثنين بداية، ولا تطبق تقويم 4-4-5 أو سنة مالية مخصصة. احفظوا أسبوع ISO السنوي في حقل منفصل. ولإعادة معالجة التاريخ السابق، قدموا تاريخ التطبيق صراحة بدلاً من طلب «اليوم».

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

لوحات الأداء الربع سنوي

ضعوا تسمية أسبوع ربع سنوي موحدة على مؤشرات الأداء المؤرخة لمقارنة الأرباع الميلادية.

متابعة الحملات

اربطوا تاريخ النشاط بكتلة الأيام السبعة المناسبة من دون الاعتماد على المنطقة الزمنية.

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

هل يبدأ الأسبوع 1 يوم الاثنين؟

لا. يبدأ في أول يوم ميلادي من الربع، وتحتوي كل كتلة تالية على سبعة أيام.

هل يساوي أسبوع ISO السنوي؟

لا. يبدأ أسبوع ISO يوم الاثنين وقد يعبر الأرباع، أما هذا الرقم فيعاد ضبطه مع كل ربع.

هل يمكن أن تصل النتيجة إلى الأسبوع 14؟

نعم. مدة الربع 90 أو 91 أو 92 يوماً، لذلك قد تقع تواريخه الأخيرة في الأسبوع 13 أو 14.

هل تقبل الطوابع الزمنية أو الصيغ المحلية؟

لا. استخدموا YYYY-MM-DD تماماً لتجنب تحولات المناطق الزمنية وترتيب التاريخ الملتبس.

متى يبدأ كل ربع من السنة؟

يبدأ الربع الأول في 1 يناير، والثاني في 1 أبريل، والثالث في 1 يوليو، والرابع في 1 أكتوبر. وفي كل يوم من هذه الأيام يعود العدّ إلى الأسبوع 1.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/week-number-in-quarter

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

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

curl -X POST https://api.kit.forhosting.com/date/week-number-in-quarter \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-05-20"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/week-number-in-quarter",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-05-20"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "date": "2026-05-20"
}

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

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

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

تعريف رقم الأسبوع داخل الربع

تتضمن الاستجابة quarter_start كي تتمكنوا من التحقق من نقطة الارتكاز.

إرسال التاريخ والتحقق منه

يقبل 29 فبراير في سنة كبيسة غريغورية فقط، وتعيد التواريخ المستحيلة invalid_input. تكلف عملية API الناجحة $0.002 لكل عنصر، بينما ينفذ المتصفح الحساب النقي نفسه محلياً. احتفظوا بتاريخ ISO الأصلي وquarter_start عند الحاجة إلى سجل تدقيق.

استخدام النتيجة في التقارير والأتمتة

تستطيع لوحة الإيرادات تجميع القياسات حسب السنة والربع وweek_number من دون امتداد أسبوع سابق عبر الحد. اختبروا تواريخ قريبة من 1 يناير وأبريل ويوليو وأكتوبر للتأكد من عودة week_number إلى واحد.

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

إثراء مستودع البيانات

أضيفوا السنة والربع وquarter_start وweek_number قبل التجميع أو إعادة المعالجة التاريخية.

أسئلة تقنية

ما تكلفة الحساب؟

الحساب مجاني في المتصفح. يكلف طلب API الناجح $0.002 لكل عنصر.

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

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

مثال محلول

تعريف رقم الأسبوع داخل الربع

إرسال التاريخ والتحقق منه

استخدام النتيجة في التقارير والأتمتة

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

لوحات الأداء الربع سنوي

متابعة الحملات

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

تعريف رقم الأسبوع داخل الربع

إرسال التاريخ والتحقق منه

استخدام النتيجة في التقارير والأتمتة

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

إثراء مستودع البيانات

أسئلة تقنية

شكرًا