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

احسب تكرار يوم محدد في سنة تاريخ ISO

احسب بدقة عدد أيام الاثنين أو الجمعة أو الأحد أو أي يوم آخر من أيام الأسبوع في السنة التقويمية التي يحددها تاريخ ISO صريح.

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

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

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

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

أدخل تاريخا صريحا ويوما من أيام الأسبوع

أرسل تاريخا مكتوبا تماما بالصيغة YYYY-MM-DD واسم يوم مثل Monday أو Tuesday أو Friday. يحدد التاريخ الصريح السنة التقويمية المطلوب فحصها، ولا يقيد الشهر واليوم نطاق العد. فعلى سبيل المثال، يحدد كل من 2024-01-01 و2024-11-30 سنة 2024 كاملة. ومع ذلك، يجب أن يمثل التاريخ الكامل يوما حقيقيا في التقويم الميلادي؛ لذلك ترفض القيم المستحيلة مثل 2023-02-29 أو الشهر الثالث عشر بدلا من تصحيحها بصمت. لا تتأثر أسماء الأيام بحالة الأحرف، كما تقبل الاختصارات الإنجليزية الشائعة المؤلفة من ثلاثة أحرف، مثل Mon وWed وSat. تكرر الاستجابة التاريخ الأصلي، وتحدد السنة المختارة، وتوحّد اسم اليوم إلى اسمه الإنجليزي الكامل، وتعرض فهرسا يبدأ بيوم الأحد. يمنع اشتراط هذين المدخلين الواضحين أي اعتماد خفي على التاريخ الحالي، ويجعل الطلبات المحفوظة قابلة لإعادة التنفيذ بالنتيجة نفسها بعد مدة طويلة. كما يلائم هذا العقد النماذج والمهام المجدولة وجداول البيانات وسجلات التدقيق التي يكون فيها العام الضمني ملتبسا.

افهم طريقة حساب العدد بصورة حتمية

تحتوي كل سنة ميلادية عادية على 365 يوما، أي 52 أسبوعا كاملا ويوم إضافي واحد. وتحتوي السنة الكبيسة على 366 يوما، أي 52 أسبوعا كاملا ويومين إضافيين. لذلك يتكرر كل يوم من أيام الأسبوع 52 مرة على الأقل. في السنة العادية، يتكرر اليوم الذي يوافق 1 يناير للمرة الثالثة والخمسين. وفي السنة الكبيسة، يتكرر اليومان الموافقان 1 و2 يناير 53 مرة لكل منهما. تطبق الحاسبة أولا قاعدة السنة الكبيسة الميلادية: تكون السنة القابلة للقسمة على أربعة كبيسة، باستثناء سنوات القرون ما لم تكن قابلة للقسمة على 400 أيضا. ثم تحسب يوم 1 يناير بحسابات صحيحة محدودة، وتتحقق مما إذا كان اليوم المختار ضمن اليوم الإضافي أو اليومين الإضافيين. لا تنشئ الحاسبة كائن JavaScript Date. ويجنب ذلك التحليل المعتمد على البيئة والمناطق الزمنية للنظام والتوقيت الصيفي والسلوك المحلي. تعرض النتيجة طول السنة وعلامة السنة الكبيسة ويوم 1 يناير حتى يمكن تفسير العدد 52 أو 53 مباشرة.

استخدم النتيجة في التخطيط والتحقق

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

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

تقدير أيام العمل المتكررة

احسب كل مرات ظهور يوم مجدول في سنة التقرير قبل طرح العطلات أو أيام الإغلاق.

مراجعة تقاويم الرواتب

تحقق مما إذا كان يوم الدفع الأسبوعي يتكرر 52 أو 53 مرة في السنة المرتبطة بتاريخ الراتب.

التحقق من بيانات التقويم

قارن مجاميع أيام الأسبوع في تقويم سنوي مولّد بمرجع ميلادي حتمي.

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

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

تبلغ تكلفة كل طلب API ‏$0.002.

لماذا يجب إدخال تاريخ كامل بدلا من السنة وحدها؟

يوفر تاريخ ISO الصريح والمتحقق منه السنة، ويلائم مسارات العمل التي تستخدم تواريخ تقارير أو تواريخ مرجعية بالفعل.

هل يمكن أن يتكرر يوم من أيام الأسبوع أكثر من 53 مرة في سنة؟

لا. تحتوي السنة الميلادية على 52 أسبوعا كاملا ويوم إضافي واحد أو يومين فقط.

هل تستبعد العطلات الرسمية؟

لا. تعد النتيجة أيام التقويم فقط ولا تطبق قواعد العطلات الإقليمية أو المؤسسية.

هل تؤثر المنطقة الزمنية في النتيجة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/count-weekday-in-year

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

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

curl -X POST https://api.kit.forhosting.com/date/count-weekday-in-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-06-15","weekday":"Monday"}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2024-06-15","weekday":"Monday"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/count-weekday-in-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-06-15",
  "weekday": "Monday"
}

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

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

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