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

رقم الأسبوع بيوم بداية مخصص

اختر اليوم الذي تبدأ به أسابيعك واحصل على رقم الأسبوع لأي تاريخ، مع بقاء الأسبوع 1 دائمًا هو أسبوع 1 يناير: يقع 15 مارس 2024 في الأسبوع 11 إذا بدأ الأسبوع يوم الاثنين. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-03-15
أول يوم في الأسبوع: monday

تحصل على

السنة: 2,024
الشهر: 3
اليوم: 15
اليوم من السنة: 75

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

ما رقم الأسبوع ببداية مخصصة وما الذي تحتويه الاستجابة

يجيب رقم أسبوع السنة عن «في أي أسبوع من هذه السنة المدنية يقع هذا التاريخ؟» بعد تثبيت كيفية بدء الأسابيع. بخلاف تاريخ الأسبوع ISO-8601 الذي يبدأ دائمًا يوم الاثنين وقد يُسند أواخر ديسمبر أو أوائل يناير إلى سنة-أسبوع أخرى، تُبقي هذه الحاسبة السنة المدنية ثابتة وتغيّر فقط يوم البداية.

تشمل الحالات المرفوضة غياب التاريخ وأشكالًا مثل 2024/03/15 وأشهرًا مستحيلة و29 فبراير خارج سنة كبيسة ورموز أيام مجهولة. إن احتجت إلى أزواج أسبوع وسنة-أسبوع ISO فاستخدم أداة رقم الأسبوع ISO المخصصة؛ وإن احتجت فقط إلى أسابيع أمريكية تبدأ الأحد فأداة الأسبوع الأمريكي تخصص ثابت من نفس العائلة. هذه الصفحة للفرق التي تختار عمدًا أول يوم في الأسبوع وتريد مع ذلك فهرس أسبوع مستقرًا داخل السنة المدنية.

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

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

يستطيع المعلمون وكُتّاب المعايير أن يُظهروا جنبًا إلى جنب أن أرقام الأسبوع ببداية الاثنين تحت قاعدة 1 يناير ليست أرقام ISO قرب حدود السنة، ما يمنع أخطاء التكلفة العالية بمقدار واحد في أوراق الامتثال. اربطها بأدوات بداية الأسبوع ونهايته عندما تحتاج حدود الاثنين أو الأحد لنفس الأسبوع، وبرقم الأسبوع ISO عندما يفرض التقرير النظامي ISO-8601، ومساعدات يوم الأسبوع عندما تحتاج اسم اليوم فقط دون فهرس أسبوع.

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

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

اطبع التقارير بتسميات أسبوع السنة التي تطابق إعداد أول يوم إقليمي (الاثنين أو الأحد أو السبت) دون التحويل إلى قواعد سنة-الأسبوع ISO.

فهارس أسبوع متوافقة مع الجداول

اعكس سلوك WEEKNUM بأسلوب Excel معممًا لأي يوم بداية للاستيراد وجداول الوقت وحزم المالية التي تبقى في السنة المدنية.

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

كيف يُعرَّف الأسبوع 1؟

الأسبوع 1 هو الأسبوع الذي يحتوي على 1 يناير من السنة المدنية. تدوم الأسابيع دائمًا سبعة أيام بدءًا من يوم الأسبوع الذي تختاره. ليست قاعدة ISO لأول خميس.

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

أسابيع ISO تبدأ دائمًا الاثنين وقد تُسند سنة-أسبوع مختلفة قرب 1 يناير. تحافظ هذه الأداة على السنة المدنية وتغيّر فقط أول يوم؛ الأسبوع 1 يشمل دائمًا 1 يناير.

هل تستخدم المناطق الزمنية أو الساعة الحالية؟

لا. تعيّن فقط تاريخ تقويم متحققًا ويوم بداية إلى حقول الأسبوع بحساب صرف. لا يوجد كائن Date ولا إزاحة منطقة زمنية ولا اعتماد على اليوم.

أي يوم بداية يُستخدم إذا لم أختر يومًا؟

يوم الاثنين. يمكنك تغييره إلى أي يوم من الأحد إلى السبت، ويبقى الأسبوع 1 هو الأسبوع الذي يضم 1 يناير أيًا كان يوم البداية الذي تختاره.

كم أسبوعًا قد تضم السنة وفق هذه القاعدة؟

تعرض النتيجة رقم أسبوع 31 ديسمبر بيوم البداية نفسه. ففي 2024، مع أسابيع تبدأ يوم الاثنين، تضم السنة 53 أسبوعًا.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/week-number-custom-start

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

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

curl -X POST https://api.kit.forhosting.com/date/week-number-custom-start \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/week-number-custom-start",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-03-15"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "date": "2024-03-15"
}

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

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

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

استخدمها مجانًا في المتصفح للوحات التخطيط والجداول حسب المنطقة، أو استدعِ واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج المسارات إلى نفس تسمية الأسبوع في كل مرة.

ما رقم الأسبوع ببداية مخصصة وما الذي تحتويه الاستجابة

تمرّر date كسلسلة صارمة YYYY-MM-DD وfirst_weekday اختياريًا كاسم إنجليزي (من sunday إلى saturday) أو عددًا صحيحًا من صفر للأحد إلى ستة للسبت؛ وعند حذف first_weekday يُفترض الاثنين. بعد التحقق تعيد الاستجابة التاريخ المطبّع والسنة المدنية والشهر واليوم والترتيب day_of_year ويوم الأسبوع للمدخل بحروف صغيرة وTitle Case مع فهرس يبدأ من صفر، وfirst_weekday وfirst_weekday_index المحلولين، وكم يومًا يبعد التاريخ عن بداية أسبوعه، وweek_number من واحد فصاعدًا، وweeks_in_year كرقم أسبوع 31 ديسمبر تحت نفس يوم البداية، وweek_1_rule بقيمة contains_january_1، وأعلام السنة الكبيسة والتقويم، ووسم method، وسلسلة صيغة قصيرة للتوثيق. لا يوجد تحويل منطقة زمنية ولا اعتماد على «اليوم»: إما أن تُشكّل المدخلات يوم تقويم حقيقيًا ويوم بداية مشروعًا، أو يفشل الطلب بـ invalid_input.

كيف تُقرأ التاريخ ويوم البداية لتبقى النتائج قابلة للتكرار

يجب أن تطابق السلسلة أربعة أرقام وشرطة ورقمين وشرطة ورقمين؛ تُقتطع المسافات من الطرفين، لكن التواريخ الجزئية وأسماء الأشهر وترتيب يوم السنة وحده لا تُوسَّع هنا. يجب أن تكون السنة بين 1 و9999 والشهر بين 1 و12 واليوم بين 1 والطول الحقيقي لذلك الشهر في تلك السنة، مع السنوات الكبيسة وفق القاعدة الغريغورية (قابلة للقسمة على أربعة إلا القرون غير القابلة للقسمة على أربعمائة). الحقل المفضل للتاريخ هو date، لكن تُقبل الأسماء البديلة iso_date وd وvalue وcalendar حتى تعيد الجداول وسلاسل الاستعلام والنماذج استخدام العقد دون إعادة تسمية الأعمدة. يقبل الحقل first_weekday أسماء أو فهارس عددية وله الأسماء البديلة week_start وstart_day وfirst_day؛ والقيم الفارغة أو المحذوفة تفترض الاثنين افتراضيًا ليبقى بدء أسبوع بأسلوب ISO على بعد ضغطة دون فرض قاعدة سنة-الأسبوع ISO. من الثلاثي المتحقق يحسب المحرك day_of_year بجمع أطوال الأشهر مع تعديل فبراير الكبيس، ثم أيام الأسبوع للتاريخ المدخل ولـ 1 يناير بطريقة ساكاموتو الصحيحة (الأحد صفر والسبت ستة). إزاحة 1 يناير داخل الأسبوع المخصص هي (يوم 1 يناير ناقص first_weekday زائد سبعة) modulo سبعة؛ ورقم الأسبوع هو أرضية day_of_year ناقص واحد زائد تلك الإزاحة، الكل مقسوم على سبعة، ثم زائد واحد. يُرجع رقم أسبوع 31 ديسمبر تحت نفس البداية كـ weeks_in_year حتى تعرف لوحات المعلومات إن كانت السنة تصل إلى 52 أو 53 أو 54 تسمية أسبوع لهذا الإعداد. اجمع التشغيل المجاني في المتصفح على هذه الصفحة مع واجهة API المدفوعة عندما تحتاج نفس تسمية الأسبوع داخل مسار آلي.

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

يمكن للمحللين الذين يبنون لوحات سنة بعد سنة تخزين week_number مع first_weekday_index لتبقى المرشحات غير ملتبسة عندما تختلف منطقتان في بداية الأسبوع. على هذه الصفحة يعمل الحساب بالكامل في متصفحك؛ وعبر API تكلف كل استعلام ناجح $0.002، ولا تُحسب أخطاء التحقق، ولا يُخزَّن شيء بعد عودة الاستجابة. هذا التقسيم—استكشاف تفاعلي مجاني وAPI مطابقة مدفوعة—يوافق بقية كتالوج KIT من المستوى A ويسمح لك بالانتقال من فحص لمرة واحدة إلى مسار دون تغيير النتيجة الرياضية.

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

تجهيزات CI حتمية

ولّد قيم week_number قابلة للتكرار لاختبارات الوحدة تحت عدة إعدادات first_weekday دون انحراف Date أو لغة المضيف.

أسئلة تقنية

كم تكلفة حاسبة رقم الأسبوع بيوم بداية مخصص؟

مجانية في متصفحك على هذه الصفحة. عبر API يكلف الطلب الناجح $0.002؛ والمدخلات غير الصالحة لا تُحسب.

ما القيم التي يقبلها first_weekday؟

أسماء إنجليزية من sunday إلى saturday (دون تمييز حالة الأحرف)، أو أعداد صحيحة 0–6 مع الأحد = 0 والسبت = 6. الافتراضي هو monday عند حذف الحقل.

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

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

مثال محلول

ما رقم الأسبوع ببداية مخصصة وما الذي تحتويه الاستجابة

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

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

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

فهارس أسبوع متوافقة مع الجداول

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

ما رقم الأسبوع ببداية مخصصة وما الذي تحتويه الاستجابة

كيف تُقرأ التاريخ ويوم البداية لتبقى النتائج قابلة للتكرار

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

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

تجهيزات CI حتمية

أسئلة تقنية

شكرًا