بداية ونهاية أسبوع ISO
أدخل أي يوم واحصل على الاثنين الذي يفتتح أسبوعه وفق ISO والأحد الذي يختمه: يقع 2024-01-03 في الأسبوع الممتد من 2024-01-01 إلى 2024-01-07. ويُحتسب اليومان كلاهما. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- التاريخ
- 2024-01-03
- السنة
- 2,024
- الشهر
- 1
- اليوم
- 3
- يوم الأسبوع ISO
- 3
تأخذ حاسبة بداية ونهاية أسبوع ISO تاريخًا واحدًا من التقويم الغريغوري بصيغة YYYY-MM-DD وتعيد يوم الإثنين الذي يفتح أسبوع ISO-8601 الذي يحتوي ذلك اليوم ويوم الأحد الذي يختمه. أسابيع ISO تمتد دائمًا من الإثنين إلى الأحد ولا تعتمد أبدًا على إعداد أول يوم أسبوع في اللغة أو المنطقة؛ لذلك تفضّلها كشوف الرواتب وحزم التصنيع وتسميات سباقات أجايل والتقارير عبر الحدود على أسابيع النمط الأمريكي التي تبدأ يوم الأحد. من الفحوصات الكلاسيكية: 2024-01-03 يقابل الأسبوع من 2024-01-01 إلى 2024-01-07، و2021-01-01 يقابل الأسبوع من 2020-12-28 إلى 2021-01-03 لأن ذلك الجمعة ما زال ينتمي إلى الأسبوع 53 من سنة الأسبوع 2020. يستخدم المحرك حسابًا تقويميًا صحيحًا وحتميًا فقط: السنوات الكبيسة وأطوال الأشهر ويوم الأسبوع ISO وإزاحات رقم اليوم اليولياني وقواعد حدود رقم الأسبوع تُحسب دون استدعاءات شبكة ودون عيّنة عشوائية ودون ساعة المضيف.
ما معنى بداية ونهاية أسبوع ISO وماذا تتضمن الاستجابة
تواريخ أسبوع ISO-8601 تضع يومًا مدنيًا داخل نافذة سبعة أيام تبدأ يوم الإثنين، مرقّمة من 1 إلى 52 أو 53 داخل سنة ترقيم الأسابيع. الأسبوع 1 هو الأسبوع الذي يحتوي أول خميس في السنة، وهو يعادل الأسبوع الذي يحتوي 4 يناير. بسبب تلك القاعدة قد ينتمي أواخر ديسمبر وأوائل يناير إلى سنة أسبوع تختلف عن السنة المدنية المطبوعة على الفاتورة، وقد يقع إثنين البداية أو أحد النهاية في شهر أو سنة تقويمية تختلف عن يوم الإدخال.
الحالات المرفوضة تشمل غياب date وشكلًا خاطئًا مثل 2024/01/03 وأشهرًا مستحيلة وأيامًا غير موجودة مثل 2023-02-29. إن احتجت أول يوم أسبوع مخصصًا أو رقم الأسبوع وحده أو تحويل سنة الأسبوع مع الأسبوع إلى تاريخ، فاستخدم تلك الأدوات المخصصة؛ تجيب هذه الصفحة فقط حدود نافذة أسبوع ISO لتاريخ تقويمي مُتحقَّق منه.
كيف تُقرأ التاريخ وكيف تبقى نافذة الإثنين–الأحد قابلة للتكرار
يجب أن تطابق السلسلة أربعة أرقام وشرطة ورقمين وشرطة ورقمين؛ تُزال المسافات البادئة أو اللاحقة، لكن التواريخ الجزئية وترتيب يوم السنة وحده وأسماء الأشهر لا تُوسَّع هنا. بعد التحليل يجب أن تقع السنة بين 1 و9999 والشهر بين 1 و12 واليوم بين 1 والطول الحقيقي لذلك الشهر في تلك السنة، وتتبع السنوات الكبيسة القاعدة الغريغورية: القسمة على أربعة باستثناء قرون غير قابلة للقسمة على أربعمئة.
يستخرج المسار نفسه أيضًا رقم أسبوع ISO كأرضية لعبارة (يوم السنة ناقص يوم الأسبوع زائد عشرة) مقسومًا على سبعة، مع تعديل سنة الأسبوع عندما يكون الأسبوع المؤقت أقل من واحد أو يتجاوز عدد أسابيع السنة المدنية. للسنة ثلاثة وخمسون أسبوعًا ISO عندما يكون أول أيامها أو آخرها خميسًا.
حالات الاستخدام
نطاقات تواريخ للتقارير الأسبوعية
حوّل أي يوم فاتورة أو سجل إلى حدود شاملة إثنين–أحد وفق ISO للوحات المعلومات وحزم التجزئة وتقارير العمليات.
نوافذ أسبوع عند حدود السنة
احسم تواريخ أواخر ديسمبر وأوائل يناير التي يبدأ أسبوعها ISO أو ينتهي في سنة مدنية مختلفة قبل إغلاق الدفاتر.
الأسئلة الشائعة
لماذا قد يقع الإثنين أو الأحد في شهر أو سنة أخرى؟
أسابيع ISO كتل متصلة من سبعة أيام. قد ينتمي أربعاء في أوائل يناير إلى أسبوع بدأ أواخر ديسمبر من السنة المدنية السابقة.
هل تحوّل المناطق الزمنية أو تستخدم الساعة الحالية؟
لا. تُسقط فقط تاريخًا تقويميًا مُتحقَّقًا منه إلى حدود إثنين–أحد لأسبوع ISO بحساب خالص. لا يوجد كائن Date ولا إزاحة منطقة زمنية ولا اعتماد على «اليوم».
هل يدخل الاثنين والأحد ضمن المدة؟
نعم، يُحتسب الطرفان كلاهما، فتغطي المدة دائمًا سبعة أيام. فبالنسبة إلى 2024-01-03 تمتد من الاثنين 2024-01-01 إلى الأحد 2024-01-07، وهي جاهزة لتقرير أسبوعي.
هل يمكن أن يبدأ الأسبوع يوم الأحد؟
لا. يمتد أسبوع ISO دائمًا من الاثنين إلى الأحد ولا يمكن تغيير يوم البداية، وبهذا تتوافق التقارير بين الدول المختلفة. وللأسابيع التي تبدأ يوم الأحد استخدم أداة مخصصة لهذا النظام.
ماذا يعرض الناتج غير التاريخين؟
يعرض رقم يوم الأسبوع لتاريخك، وكم يومًا يبعد عن الاثنين، ورقم أسبوع ISO وسنة الأسبوع مع رمز مثل 2024-W01، وعدد أسابيع تلك السنة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/date/iso-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/iso-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/iso-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/iso-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/iso-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.iso_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 | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
استخدمها مجانًا في المتصفح لجداول التخطيط وفحوص الامتثال، أو استدعِ واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج حدود نافذة أسبوع قابلة للتكرار في التكامل المستمر أو مسارات التقارير أو ميزات المنتج.
ما معنى بداية ونهاية أسبوع ISO وماذا تتضمن الاستجابة
تقبل هذه الحاسبة حقلًا إلزاميًا واحدًا هو date كسلسلة صارمة YYYY-MM-DD، وتتحقق من أن اليوم موجود فعليًا في التقويم الغريغوري — بما في ذلك 29 فبراير في السنوات الكبيسة فقط والطول الصحيح لكل شهر — ثم تعيد التاريخ المطبّع والسنة والشهر واليوم المدنيين، ويوم الأسبوع ISO من 1 للإثنين إلى 7 للأحد مع اسم مقروء، وكم يومًا بعد الإثنين يقع الإدخال، وweek_start وweek_end كتاريخين ISO شاملين، ورقم أسبوع ISO وسنة الأسبوع مع سلسلة مضغوطة iso_week_string مثل 2020-W53، وعدد الأسابيع في سنة الأسبوع تلك، وترتيب يوم السنة، ومراسي رقم اليوم اليولياني للإدخال ولطرفي الأسبوع، وlength_days يساوي سبعة، وتذكيرًا قصيرًا بالصيغة. لا يوجد تحويل منطقة زمنية ولا أول يوم أسبوع قابل للضبط ولا تقريب عائم: إما أن الإدخال يوم تقويمي حقيقي فيُحدَّد زوج الإثنين–الأحد بالكامل، أو يفشل الطلب بـ invalid_input.
كيف تُقرأ التاريخ وكيف تبقى نافذة الإثنين–الأحد قابلة للتكرار
الحقل المفضّل هو date، لكن تُقبل الأسماء البديلة iso_date وd وvalue حتى تعيد جداول البيانات وسلاسل الاستعلام والنماذج المُنَوَّعة استخدام العقد نفسه دون إعادة تسمية الأعمدة. من الثلاثية المُتحقَّق منها يحسب المحرك يوم الأسبوع ISO بطريقة ساكاموتو الصحيحة الخالصة بحيث يكون الإثنين واحدًا والأحد سبعة، ويحوّل اليوم المدني إلى رقم يوم يولياني فلكي بخوارزمية Fliegel–Van Flandern، ويطرح days_from_monday المساوي لـ iso_weekday ناقص واحد للوصول إلى الإثنين، ويضيف ستة أيام للوصول إلى الأحد. اقرن التشغيل المجاني في متصفح هذه الصفحة بواجهة API المدفوعة عندما تحتاج نافذة الأسبوع نفسها داخل مسار آلي.
أين تناسب بداية ونهاية أسبوع ISO التخطيط والتقارير والبرمجيات
تحتاج فرق العمليات والمالية إلى إثنين وأحد أسبوع ISO عندما يجب أن تتوافق إيقاعات أسبوعية عبر بلدان لا تبدأ كلها الأسبوع يوم الأحد: جداول التصنيع وحزم البيع بالتجزئة وتسميات سباقات أجايل والتقارير النظامية التي تذكر أسبوع السنة تستفيد من نافذة شاملة بلا لبس. يستدعي المطوّرون العقد نفسه من سكربتات لختم دلاء السجلات وتوليد نطاقات افتراضية لجداول الوقت أو إنتاج متجهات اختبار حتمية لأنظمة الرواتب التي تُغلق ليلة الأحد. يستخدم المعلمون وكتّاب المعايير الأداة لإظهار تواريخ حدودية مثل 2005-01-01 داخل أسبوع بدأ في ديسمبر 2004 دون الاعتماد على أرقام تسلسلية للجداول تختلف بين Excel وISO. يتجنب المحللون الذين يبنون لوحات سنةً بعد سنة مرشحات الانحراف بمقدار واحد عندما يخزّنون week_start وweek_end معًا بدل رقم أسبوع وحده ما زال يحتاج توسيعًا إلى محمولات تاريخ. في هذه الصفحة يعمل كل شيء داخل متصفحك؛ عبر API يكلّف كل استعلام ناجح $0.002، ولا تُحسب التحقق الفاشل، ولا يُخزَّن شيء بعد عودة الاستجابة. ذلك التقسيم — استكشاف تفاعلي مجاني وAPI مدفوعة مطابقة — يوافق بقية كتالوج KIT من الفئة A ويتيح لك الانتقال من فحص لمرة واحدة إلى مسار دون تغيير النتيجة الرياضية. اقرنها باستعلام رقم أسبوع ISO عندما تحتاج معرّف الأسبوع فقط، وبـ week_start_end القابل للضبط عندما تهم أيام الأسبوع الأولى في اللغة، وبمساعدات حتمية مجانية أخرى عندما تبني مختبرًا صغيرًا لأدوات التاريخ.
حالات التكامل
تجهيزات اختبار حتمية
ولّد قيم week_start وweek_end قابلة للتكرار لاختبارات الوحدة وفحوص الخصائص وتأكيدات التكامل المستمر دون انحراف Date.
أسئلة تقنية
كم تكلفة حاسبة بداية ونهاية أسبوع ISO؟
هي مجانية في متصفحك في هذه الصفحة. عبر API يكلّف الطلب الناجح $0.002؛ والمدخلات غير الصالحة لا تُحسب.
أي يومان هما week_start وweek_end؟
وفق ISO-8601، week_start دائمًا الإثنين وweek_end دائمًا الأحد. لا يوجد خيار لبدء الأسبوع يوم الأحد أو أي يوم آخر.
ما صيغ التاريخ المقبولة؟
تواريخ تقويمية صارمة YYYY-MM-DD فقط. قيم مثل 2024/01/03 أو 01-03-2024 أو 2023-02-29 (غير كبيسة) تُرفض بـ invalid_input.