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

يوم رأس السنة

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

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

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

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

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

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

أدخل تاريخًا ميلاديًا صريحًا بصيغة ISO على النمط YYYY-MM-DD. تتحقق الحاسبة من صحة التاريخ كاملًا، بما في ذلك عدد أيام الشهر وقاعدة فبراير الخاصة في السنوات الكبيسة، ثم تعتمد جزء السنة لإجراء الحساب. فإذا أُدخل تاريخ من أغسطس 2026، لا تحسب الأداة يوم الأسبوع لذلك التاريخ في أغسطس، بل تعيد عمدًا يوم الأسبوع الموافق 1 يناير 2026. يفيد ذلك عندما يحتوي سجل أو موعد نهائي أو فاتورة أو حدث على تاريخ بالفعل، وتحتاج إلى معلومة عن بداية السنة نفسها. كما يمنع اشتراط تاريخ كامل وصحيح المدخلات الملتبسة مثل 03/04/26، إذ يختلف ترتيب الشهر واليوم باختلاف الأعراف الإقليمية. تقبل الأداة السنوات من 0001 إلى 9999، وتطبق التقويم الغريغوري الاستباقي باتساق على هذا النطاق كله. يكرر الناتج القيمة المقبولة، ويحدد السنة المستخرجة، ويعرض تاريخ رأس السنة بصيغته الموحدة، حتى يظل أساس الإجابة ظاهرًا لا ضمنيًا.

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

يحصي الحساب أيام جميع السنوات المكتملة التي تسبق السنة المُدخلة. تضيف السنة العادية 365 يومًا، بينما تضيف السنة الكبيسة يومًا آخر وفق القاعدة الغريغورية: تكون السنة القابلة للقسمة على أربعة كبيسة، إلا إذا كانت قابلة للقسمة على مئة، وتظل السنوات القابلة للقسمة على أربعمئة كبيسة. ثم يُختزل المجموع بترديد سبعة، مع اعتبار الاثنين يوم ISO رقم 1 والأحد يوم ISO رقم 7. تحدد هذه العمليات الحسابية مباشرة يوم الأسبوع الذي يبدأ فيه 1 يناير. لا تشارك في النتيجة ساعة النظام أو الإعدادات المحلية أو قاعدة بيانات المناطق الزمنية أو قيمة عشوائية أو طلب شبكي أو كائن Date في JavaScript. لذلك ينتج عن الإدخال الصحيح نفسه رد JSON مطابق سواء نُفذ عبر API أو في متصفح ببلد آخر أو ضمن اختبار مضبوط على منطقة زمنية مختلفة. ويجمع الرد بين اسم اليوم المقروء ورقم ISO، فيناسب العرض والفرز والتفرع والدمج مع الأنظمة الأخرى.

طبّق النتيجة في التخطيط والأتمتة

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

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

إنشاء مخطط سنوي

اختر عمود يوم الأسبوع الصحيح لـ1 يناير قبل إنشاء الأسابيع المتبقية من التقويم السنوي.

تصنيف بداية السنة

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

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

قارن يوم 1 يناير المحسوب بتقرير تاريخي أو تقويم مستورد وفق قواعد غريغورية متسقة.

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

ما صيغة التاريخ التي ينبغي إرسالها؟

أرسل تاريخ ISO كاملًا بصيغة YYYY-MM-DD، مثل 2026-08-07.

هل يؤثر الشهر أو اليوم في الإجابة؟

يجب أن يشكلا تاريخًا صحيحًا، لكن الحساب يستخدم سنة ذلك التاريخ لتقييم 1 يناير الموافق.

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

لا. يستخدم الحساب عمليات صحيحة وفق التقويم الغريغوري، ولا يحول الإدخال إلى توقيت محلي.

كيف تُعامل السنوات الكبيسة؟

السنوات القابلة للقسمة على أربعة كبيسة، وسنوات القرون ليست كذلك، إلا إذا كانت قابلة للقسمة على أربعمئة أيضًا.

ما التكلفة؟

التنفيذ مجاني في المتصفح. تكلف كل مطالبة عبر API مقدار $0.002.

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

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

الـEndpoint

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

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

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

curl -X POST https://api.kit.forhosting.com/date/weekday-of-new-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-07"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekday-of-new-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-08-07"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "date": "2026-08-07"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekday_of_new_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 الكامل ←