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

رقم أسبوع ISO 8601

أدخل تاريخًا واحصل على رقم أسبوعه وفق ISO 8601 وسنة الأسبوع: يقع 25 يوليو 2026 في الأسبوع 30، ويُكتب 2026-W30. تمتد الأسابيع من الاثنين إلى الأحد، والأسبوع 1 هو الذي يضم أول خميس في السنة. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2026-07-25

تحصل على

الأسبوع: 30
سنة الأسبوع: 2,026
أسبوع ISO: 2026-W30
يوم الأسبوع: 6

بخلاف الأسابيع ذات الطابع الأمريكي التي غالبًا تبدأ يوم الأحد ولا تمتد إلى سنة أخرى، يبدأ أسبوع ISO دائمًا يوم الاثنين، والأسبوع 1 هو الأسبوع الذي يحتوي على أول خميس من السنة الميلادية. تعني هذه القاعدة أن أواخر ديسمبر وأوائل يناير قد تنتمي إلى سنة أسبوع ISO تختلف عن السنة التقويمية المطبوعة على التاريخ. تستقبل هذه القدرة سلسلة تاريخ ISO واحدة، وتفسرها كيوم مدني بالتوقيت العالمي المنسق، وتعيد رقم الأسبوع (1–53)، وسنة الأسبوع ISO، وتسمية مضغوطة YYYY-Www، ويوم الأسبوع — بطريقة حتمية دون تخمين المنطقة الزمنية.

ما الذي يعنيه رقم أسبوع ISO فعليًا

كثيرًا ما يُقال «رقم الأسبوع» ويقصد به ثلاثة أشياء مختلفة: الأسبوع الترتيبي من السنة التقويمية بدءًا من 1 يناير، أو أسبوع الشهر (الأول حتى الخامس داخل شهر)، أو أسبوع ISO 8601 المعرّف في المعيار الدولي. الأخير وحده مستقر في البلدان التي تتبع تقويمات ISO. بموجب ISO 8601، لكل أسبوع سبعة أيام من الاثنين إلى الأحد.

الأسبوع 1 من السنة Y هو الأسبوع الذي يتضمن أول خميس لـ Y — ويعادل الأسبوع الذي يحتوي على 4 يناير. لذلك قد تحتوي السنة على 52 أو 53 أسبوع ISO. عندما يكون هناك 53 أسبوعًا، قد يبقى 29 أو 30 أو 31 ديسمبر في الأسبوع 53 من تلك السنة ISO، وقد ينتمي 1–3 يناير من السنة التقويمية التالية بعدُ إلى الأسبوع 52 أو 53 من سنة الأسبوع ISO السابقة.

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

عقد الإدخال والتقييم بالتوقيت العالمي فقط

أرسلوا حقلًا إلزاميًا واحدًا، date، كسلسلة ISO-8601. الصيغة المفضلة هي YYYY-MM-DD (مثل 2026-07-25). تُقبل طابع زمني كامل مع وقت ولاحقة منطقة اختيارية، لكن يُستخدم يوم التقويم فقط بعد تحليل السلسلة؛ ويجري الحساب دائمًا على ذلك اليوم المدني عند منتصف الليل بالتوقيت العالمي.

القيم المفقودة أو غير النصية تفشل أيضًا في التحقق ولا تُفوتر. ولأن الخوارزمية لا تقرأ Date.now() ولا المنطقة الزمنية المحلية للخادم أبدًا، فإن نفس الإدخال ينتج دائمًا نفس الإخراج في كل بيئة — المتصفح أو عامل الحافة أو مشغّل الاختبارات — وهو ما تحتاجه الأمثلة الذهبية وخطوط الأنابيب الدفعية.

أين تستخدم خطوط الأنابيب أرقام الأسابيع وكيف تستدعون

مؤشرات الأداء الأسبوعية، ولوحات السبرنت، والتقارير المالية التي تتبع أسابيع ISO، وفتحات اللوجستيات الموسومة بالأسبوع، ومهام إثراء CSV، كلها تحتاج فهرس أسبوع موثوقًا. حالات حدّية تستحق الاختبار في تجهيزاتكم: 2021-01-01 (أسبوع ISO 53 لعام 2020)، و2019-12-30 (أسبوع ISO 1 لعام 2020)، وتواريخ منتصف العام مثل 2026-07-25 (الأسبوع 30 لعام 2026). هذه الحالات الثلاث وحدها تلتقط أخطاء الإزاحة بواحد بين الاثنين/الأحد، وأخطاء سنة الأسبوع عند حدود السنة، وتنسيق الحشو للأسابيع ذات الرقم الواحد.

حافظوا على عقد UTC: إذا احتجتم منتصف ليل محليًا في منطقة أخرى، حوّلوا أولًا إلى التاريخ المدني المحلي ثم مرّروا ذلك YYYY-MM-DD هنا ليبقى حساب الأسبوع نقيًا وقابلًا لإعادة الإنتاج.

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

تحليلات أسبوعية وتجميع مؤشرات الأداء

جمّعوا الأحداث حسب أسبوع ISO وسنة الأسبوع حتى يقع مرور ديسمبر ويناير في أسبوع التقرير الصحيح بدل السنة التقويمية الخاطئة.

تقويمات الرواتب والتصنيع

وسّموا جداول الدوام والورديات ودفعات الإنتاج بأرقام أسابيع ISO المتوافقة مع أنظمة التخطيط الأوروبية والمتوافقة مع ISO.

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

ما رقم أسبوع ISO 8601؟

هو فهرس الأسبوع من 1 إلى 53 المعرّف في ISO 8601: تبدأ الأسابيع يوم الاثنين، والأسبوع 1 هو الذي يحتوي على أول خميس من السنة (أو، على نحو مكافئ، 4 يناير).

هل الحساب بالتوقيت المحلي أم بالتوقيت العالمي؟

بالتوقيت العالمي فقط. يُعامل التاريخ كيوم مدني UTC (YYYY-MM-DD). تُتجاهل لواحق الوقت الاختيارية في حساب الأسبوع لتبقى النتائج حتمية عبر المناطق الزمنية.

لماذا قد تنتمي أيام يناير الأولى إلى أسبوع السنة السابقة؟

لأن أسبوع ISO ينتمي إلى سنة أسبوع قد تختلف عن السنة التقويمية. فقد تقع أيام 1 إلى 3 يناير في الأسبوع 52 أو 53 من سنة ISO السابقة.

كم أسبوع ISO في السنة؟

إما 52 أو 53. فالأسبوع 1 هو الذي يضم 4 يناير، لذلك قد يقع 29 أو 30 أو 31 ديسمبر في الأسبوع 53 في السنوات التي تضم 53 أسبوعًا.

هل يمكنني إدخال تاريخ مع الوقت؟

نعم. يُقبل التاريخ مع الوقت، حتى مع المنطقة الزمنية، لكن لا يُستخدم إلا اليوم التقويمي. ويُحسب الأسبوع دائمًا على ذلك اليوم عند منتصف الليل بتوقيت UTC.

أدوات ذات صلة

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

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

الـEndpoint

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

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

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

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

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

import os, requests

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

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

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

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

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

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

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

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

ترقيم الأسابيع وفق ISO 8601 هو المعيار المستخدم في التقارير الأوروبية، وتقويمات الرواتب، وجداول التصنيع، والعديد من واجهات API.

عقد الإدخال والتقييم بالتوقيت العالمي فقط

التواريخ المستحيلة مثل 2026-02-30 تُرفض بـ invalid_input بدل أن تتقدمها تنفيذ Date على المضيف. تتضمن الاستجابة التاريخ المُطبَّع، وweek (1–53)، وweek_year (سنة الأسبوع ISO التي قد تختلف عن السنة الميلادية قرب الحدود)، وiso_week بالشكل المضغوط 2026-W30، إضافة إلى weekday (الاثنين=1 … الأحد=7) وweekday_name للقراءة.

أين تستخدم خطوط الأنابيب أرقام الأسابيع وكيف تستدعون

استخدموا أداة المتصفح المجانية للفحوصات الفردية، أو واجهة API المسبقة الدفع عند تطبيع آلاف الصفوف: كل عنصر ناجح يُسعَّر بالأساس المنشور $0.002، والإدخال غير الصالح مجاني. اقرنوا هذه القدرة بتطبيع التواريخ عندما تكون بيانات المصدر غير مرتبة، ثم عيّنوا كل يوم ISO منظَّف إلى week وweek_year قبل التجميع.

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

إثراء CSV ومستودع البيانات

أضيفوا أعمدة week وiso_week إلى خطوط التصدير لتتمكن أدوات ذكاء الأعمال من تجميع الصفوف دون إعادة تنفيذ قواعد ISO في لهجات SQL.

أسئلة تقنية

لماذا قد يختلف week_year عن السنة التقويمية؟

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

ما صيغ التاريخ المقبولة؟

يُفضَّل YYYY-MM-DD. تُقبل طوابع ISO الزمنية الكاملة إن بدأت بتاريخ تقويم صالح؛ التواريخ المستحيلة والقيم المفقودة تعيد invalid_input.

كم تكلفة واجهة API لرقم أسبوع ISO؟

أداة المتصفح مجانية. تستخدم استدعاءات API الناجحة رصيدًا مسبق الدفع بالسعر الأساسي المنشور $0.002 لكل عنصر؛ ولا تُحصَّل رسوم على الإدخال غير الصالح.

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

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

مثال محلول

ما الذي يعنيه رقم أسبوع ISO فعليًا

عقد الإدخال والتقييم بالتوقيت العالمي فقط

أين تستخدم خطوط الأنابيب أرقام الأسابيع وكيف تستدعون

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

تحليلات أسبوعية وتجميع مؤشرات الأداء

تقويمات الرواتب والتصنيع

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

عقد الإدخال والتقييم بالتوقيت العالمي فقط

أين تستخدم خطوط الأنابيب أرقام الأسابيع وكيف تستدعون

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

إثراء CSV ومستودع البيانات

أسئلة تقنية

شكرًا