بداية الأسبوع ونهايته
أدخل يومًا واحصل على أول يوم وآخر يوم في أسبوعه: الأربعاء 3 يناير 2024 يقع في الأسبوع من الاثنين 1 إلى الأحد 7 يناير. يبدأ الأسبوع يوم الاثنين أو في اليوم الذي تختاره. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- التاريخ
- 2024-01-03
- أول يوم في الأسبوع
- monday
- فهرس أول يوم
- 1
- يوم الأسبوع
- wednesday
- فهرس يوم الأسبوع
- 3
- أيام من البداية
- 2
العثور على أول وآخر يوم تقويمي في الأسبوع الذي يحتوي تاريخًا معيّنًا حاجة شائعة في جداول الساعات ولوحات السبرنت وتقويمات المدارس وفترات الرواتب ولوحات التقارير. من يبحث عن حاسبة بداية ونهاية الأسبوع يعرف بالفعل يومًا داخل الأسبوع ويحتاج المدى الكامل من الاثنين إلى الأحد أو من الأحد إلى السبت دون العد على الأصابع. تقبل هذه الأداة تاريخًا تقويميًا ISO صارمًا بصيغة سنة-شهر-يوم، وإعدادًا اختياريًا لأول يوم في الأسبوع (الاثنين افتراضيًا لأسابيع نمط ISO، أو الأحد لأسابيع النمط الأمريكي)، وتتحقق من أن اليوم موجود فعليًا في التقويم الغريغوري بما في ذلك فبرايات الكبيسة، وتحسب يوم الأسبوع بطريقة ساكاموتو، وتعيد بداية الأسبوع ونهايته الشاملتين كسلاسل ISO مع أرقام اليوم اليولياني والإزاحة من بداية الأسبوع. القواعد المستحيلة مثل التاسع والعشرين من فبراير في سنة عادية تفشل بخطأ تحقق واضح بدل الالتفاف بصمت.
كيف تُحسب بداية الأسبوع ونهايته
ابدأ بتاريخ تقويمي مدني مكتوب كسنة وشهر ويوم بالصيغة الدولية ISO مع شرطات وعروض ثابتة حتى يتفق كل عميل على الأعداد الصحيحة الثلاثة نفسها. تأكد أن السنة ضمن نطاق غريغوري عملي من السنة واحد إلى تسعة آلاف وتسعمائة وتسعة وتسعين، وأن الشهر بين واحد واثني عشر، وأن اليوم موجود لذلك الشهر وفق قواعد الكبيسة الغريغورية: السنة كبيسة عندما تقبل القسمة على أربعة، باستثناء أن سنوات القرن كبيسة فقط عندما تقبل القسمة أيضًا على أربعمائة.
تجعل هذه القاعدة التاسع والعشرين من فبراير قانونيًا في سنوات مثل ألفين وأربعة وعشرين وألفين، وغير قانوني في ألفين وثلاثة وعشرين وتسعمائة وتسعين. ثم حل إعداد أول يوم في الأسبوع: أسماء إنجليزية من sunday إلى saturday أو فهارس رقمية من صفر إلى ستة مع الأحد يساوي صفرًا والاثنين يساوي واحدًا، والافتراضي الاثنين عند الحذف لتكون أسابيع نمط ISO المسار الشائع. احسب يوم الأسبوع للتاريخ المعطى بطريقة ساكاموتو الصحيحة التي لا تستشير ساعة المضيف أبدًا.
حوّل اليوم المدني إلى رقم يوم يولياني فلكي بصيغة فليغل وفان فلانديرن، واطرح الإزاحة المعيارية وهي عدد الأيام منذ بداية الأسبوع المضبوطة، وأضف ستة للحصول على نهاية الأسبوع الشاملة. التحويل اليولياني العكسي يعطي سلاسل ISO المدنية للبداية والنهاية.
أين تظهر حاسبات حدود الأسبوع في العمل الحقيقي
يربط مديرو البرامج وسكرام ماسترز أي يوم في منتصف السبرنت بكتلة الاثنين–الأحد أو بأول يوم مخصص يحتويه للوحات السعة ومخططات الـ burndown. تحوّل فرق الموارد البشرية والرواتب يوم عمل إلى أسبوع الدفع الذي يحتويه دون تحميل مكتبة جدولة كاملة أو الاعتماد على إعدادات خادم محلية. يحوّل المعلمون وإداريو المدارس أي يوم دراسي إلى بداية الأسبوع ونهايته لكشوف الحضور ورسائل أولياء الأمور.
يجسّد مهندسو التحليلات مفاتيح دلاء أسبوعية للوحات بحيث تُجمَّع الأحداث حسب بداية الأسبوع المدنية بدل اقتطاعات ساعة المضيف الاعتباطية التي تتزحزح مع التوقيت الصيفي. إذا احتجتم لاحقًا أسابيع كاملة بين تاريخين، أو عدّ أيام نهاية الأسبوع داخل نطاق، أو اليوم النوني من الأسبوع في شهر، أو جمع أيام صرفًا إلى أساس واحد، فعاملوها كنوايا بحث وصفحات هبوط منفصلة بدل إثقال صفحة بداية الأسبوع ونهايته هذه.
حالات الاستخدام
حدود أسبوع السبرنت وجداول الساعات
اربطوا أي تاريخ عمل في منتصف الأسبوع بالنطاق الشامل من الاثنين إلى الأحد أو من الأحد إلى السبت لجداول الساعات ولوحات السبرنت وتقارير السعة دون انحراف منطقة زمنية للمضيف.
فترات الرواتب والحضور
حوّلوا يوم عمل أو دراسة إلى سلاسل ISO لبداية الأسبوع ونهايته المستخدمة في دورات الرواتب وكشوف حضور المدارس والتقويمات الموجّهة لأولياء الأمور.
الأسئلة الشائعة
ماذا تعني بداية الأسبوع ونهايته؟
تعني أول وآخر يوم تقويمي مدني في الأسبوع ذي الأيام السبعة الذي يحتوي تاريخكم، وفق إعداد أول يوم مثل الاثنين أو الأحد، دون قواعد أيام عمل أو ساعة جدارية.
ما تنسيق التاريخ المطلوب؟
ISO صارم YYYY-MM-DD بسنة من أربعة أرقام وشهر ويوم من رقمين. تُرفض قيم مثل 2024-1-3 أو 2024/01/03 حتى يتفق كل عميل.
ماذا يحدث مع تاريخ غير صالح مثل 2023-02-29؟
توضح رسالة الخطأ أن اليوم غير صالح لتلك السنة والشهر في حقل date.
في أي يوم يبدأ الأسبوع افتراضيًا؟
يوم الاثنين، كما في أسابيع ISO. ويمكنك اختيار الأحد كما في الولايات المتحدة أو أي يوم آخر، ويضم الأسبوع الناتج دائمًا سبعة أيام ويحتوي على التاريخ الذي أدخلته.
هل يمكن أن يمتد الأسبوع إلى شهر أو سنة أخرى؟
نعم. إذا بدأ الأسبوع يوم الأحد، يقع الأربعاء 3 يناير 2024 في الأسبوع من 31 ديسمبر 2023 إلى 6 يناير 2024. ويُعرض الحدّان كاملين.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/date/week-start-end \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-01-03"}'const res = await fetch("https://api.kit.forhosting.com/date/week-start-end", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-01-03"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/week-start-end",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-01-03"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/week-start-end", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-01-03"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-01-03"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/week-start-end", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"date": "2024-01-03"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.week_start_end",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
ما ترسلونه وما تستلمونه
أرسلوا حقل سلسلة إلزامي date كيوم تقويمي ISO صارم مثل ألفين وأربعة وعشرين شرطة صفر واحد شرطة صفر ثلاثة، وfirst_weekday اختياري مثل monday أو sunday أو فهرس من صفر إلى ستة. غياب date، وقيم غير سلسلة، وسلاسل لا تطابق نمط الأرقام أربعة-اثنان-اثنان، وتواريخ تطابق النمط لكنها ليست أيامًا تقويمية حقيقية، ورموز أيام أسبوع مجهولة تفشل كلها بـ invalid_input ولا تُحسب. عند النجاح ترد الاستجابة التاريخ المطبّع، واسم وفهرس first_weekday المحلولين، واسم وفهرس يوم الأسبوع ليوم الإدخال، وdays_from_start كإزاحة من صفر إلى ستة من بداية الأسبوع، وweek_start وweek_end كسلاسل ISO شاملة، وأرقام اليوم اليولياني للإدخال والحدّين، وlength_days دائمًا سبعة، وسلسلة صيغة قصيرة توثّق مسار ساكاموتو وJDN. تشمل الفحوصات الكلاسيكية الأربعاء الثالث من يناير ألفين وأربعة وعشرين مع أسابيع تبدأ بالاثنين فتعطي من الأول إلى السابع من يناير، ونفس التاريخ مع أسابيع تبدأ بالأحد فيعطي من الحادي والثلاثين من ديسمبر ألفين وثلاثة وعشرين إلى السادس من يناير ألفين وأربعة وعشرين، وإدخالًا هو بالفعل أول يوم في الأسبوع فيعيد ذلك اليوم كـ week_start مع days_from_start صفر. تسعير استدعاءات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.
أين تظهر حاسبات حدود الأسبوع في العمل الحقيقي
ولأن هذه القدرة محرك parse نقي، تسعير API هو الأساس المنشور $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.
حالات التكامل
مفاتيح دلاء أسبوعية للتحليلات
اشتقوا مفاتيح week_start مدنية مستقرة لتجميع الأحداث ولوحات الأفواج بحيث تتبع الدلاء قاعدة أول يوم نفسها في كل بيئة.
أسئلة تقنية
ما أول يوم في الأسبوع الافتراضي؟
الاثنين، بما يوافق أسابيع نمط ISO الشائعة. مرّروا first_weekday كـ sunday (أو 0) لأسابيع النمط الأمريكي، أو أي اسم يوم آخر أو فهرس 0–6.
كم التكلفة؟
أداة المتصفح مجانية وتعمل محليًا. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل عنصر ناجح؛ الإدخال غير الصالح لا يُحسب.