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

حاسبة تاريخ الجمعة السوداء حسب السنة

تعيد حاسبة تاريخ الجمعة السوداء يوم الجمعة الذي يلي مباشرة عيد الشكر في الولايات المتحدة للسنة التي تحددها.

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

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

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

كيفية تحديد تاريخ الجمعة السوداء

الجمعة السوداء في الولايات المتحدة هي اليوم التالي لعيد الشكر. ويوافق عيد الشكر الأمريكي الخميس الرابع من نوفمبر، لذلك يبدأ الحساب بتحديد يوم الأسبوع الذي يوافق 1 نوفمبر في السنة الميلادية المطلوبة. بعد ذلك يُحدَّد الخميس الأول، وتضاف ثلاثة أسابيع كاملة للوصول إلى الخميس الرابع، ثم يُنتقل يومًا تقويميًا واحدًا إلى الأمام. تنتج هذه القاعدة تاريخًا يقع بين 23 و29 نوفمبر. تعيد القدرة التاريخين معًا لكي يتسنى لك معرفة العطلة التي تستند إليها الإجابة، بدلًا من تلقي قيمة منفردة بلا تفسير. ولا تُستشار أي قائمة للعطلات، ولذلك لا تتوقف النتيجة على تحديث قاعدة بيانات. تعطي السنة نفسها النتيجة نفسها دائمًا. وهذا مفيد للتخطيط المستقبلي، والمقارنات التاريخية، والأنظمة التي تحتاج إلى قاعدة تقويمية ثابتة بدلًا من قائمة تواريخ تُصان يدويًا. يتبع الحساب العلاقة المعتمدة مع العطلة الأمريكية، ولا يحاول تمثيل فعاليات تجارية في دول أخرى قد تستخدم اسم الجمعة السوداء وفق جداول مختلفة.

حساب حتمي وفق التقويم الميلادي

تستخدم الحاسبة عمليات حسابية صحيحة على التقويم الميلادي الاستباقي. فهي تحصي السنوات المكتملة، وتطبق قاعدة السنوات الكبيسة المعروفة، وتحدد إزاحة يوم الأسبوع حتى نوفمبر. تكون السنة القابلة للقسمة على أربعة كبيسة عادة، وتُستثنى سنوات القرون، ثم تُعاد السنوات القابلة للقسمة على أربعمائة. تؤثر هذه القواعد في يوم الأسبوع الذي يبدأ به نوفمبر، على الرغم من أن الشهر المطلوب يأتي بعد فبراير بزمن طويل. لا يقرأ التنفيذ ساعة النظام، ولا يفترض منطقة زمنية محلية، ولا يتصل بخدمة شبكية، ولا يعتمد على الإعدادات الإقليمية للحاسوب. لذلك يحصل الطلب المرسل من UTC أو نيويورك أو طوكيو أو أي منطقة زمنية أخرى على التاريخ نفسه بتنسيق ISO. تُقبل السنوات من 1 إلى 9999، وتُعرض بأربعة أرقام مع أصفار بادئة للسنوات المبكرة. يحافظ هذا النطاق على التوافق مع تمثيل ISO التقليدي ذي الأرقام الأربعة، ويوفر مجالًا واسعًا للحسابات التاريخية والمستقبلية. ويُطبَّق التقويم باتساق على الفترات السابقة لاعتماده الرسمي أيضًا.

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

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

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

إنشاء تقويم لحملة تجارية

احسب الموعد السنوي المرجعي قبل جدولة مراجعات المواد الإبداعية وإطلاق المنتجات وتذكيرات العروض.

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

وائم تقارير السنوات المختلفة مع الجمعة السوداء الفعلية لكل سنة، لا مع تاريخ ثابت في نوفمبر.

إنشاء تواريخ للتخطيط المستقبلي

املأ التقاويم ومحطات مسارات العمل لسنوات عديدة من دون صيانة جدول للعطلات.

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

كيف يُحسب تاريخ الجمعة السوداء؟

تحدد الحاسبة الخميس الرابع من نوفمبر، وهو عيد الشكر الأمريكي، ثم تعيد اليوم التالي له.

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

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن تنفيذ الحساب الحتمي نفسه محليًا في المتصفح أيضًا.

هل يعتمد الحساب على منطقتي الزمنية؟

لا. فهو يستخدم حساب التقويم ويعيد تاريخ ISO نفسه بصرف النظر عن الموقع أو المنطقة الزمنية.

ما السنوات المقبولة؟

يجب أن يكون الإدخال عددًا صحيحًا من 1 إلى 9999 وفق التقويم الميلادي الاستباقي.

هل تقع الجمعة السوداء دائمًا في نوفمبر؟

نعم وفق هذا التعريف الأمريكي. يقع التاريخ بين 23 و29 نوفمبر لأنه يلي الخميس الرابع.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/black-friday

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

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

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

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

import os, requests

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

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

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

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

{
  "year": 2026
}

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

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